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项 目 说 明 


e. 本 书 美文 版 版 权 由 原作 者 所 有 ， 前 言及 本 书 内 容 介 绍 两 章 由 CliffPeng(Hairui) 翻 
译 ， 其 他 章节 由 ZZJ 翻 译 完 成 ， 经 ClifPeng 整 理 成 wiki 。 


e 中 文 译文 为 译 者 学 习 笔 记性 质 ， 但 非 经 译 者 允许 请 勿 转载 及 摘录 用 作 商 业 盈 利 
目的 。 


e 经 网 友 介 绍 ， 在 http://www.pythontik.com 找 到 了 由 zzj 翻 译 的 稿件 ， 经 征 得 同 
意 ， 转 载 于 此 ， 作 为 日 后 学 习 提 高 的 基础 。 
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项 目 日 志 
e 2007 年 10 月 03 日 ，ClifPeng 从 http:/www.pythontik.com 处 下 载 了 由 zj 完成 的 
多 数 章节 翻译 稿 ， 并 整理 了 1-12 章 的 部 分 wiki 格式 。 


。2008 年 02 月 23 日 ，CliffPeng 在 ZQ 的 开导 下 重新 启动 本 翻译 项 目 ， 从 zj 的 网 站 
下 载 了 更 多 章节 ， 整 理 了 目录 。 


。 2008 年 03 月 12 日 ，CliffPeng 初 步 完 成 了 辅助 (给 所 有 非 代 码 美 文 增加 ， 写 ) 
脚本 编写 ， 进 入 文本 整理 阶段 。 


关于 Harri Pasanen 和 Robin Dunn 以 及 wxPython 的 传奇 故事 确切 的 开始 
时 间 是 1995 年 。 本 书 的 合 著 者 之 一 ，Robin 写 下 了 下 面 这 段 关 于 wxPython 的 文 


字 ， 


而 我 们 决定 让 故事 由 参与 者 自己 来 讲述 ， 而 不 是 籍 由 旁人 加 以 引述 : 


e 1995 年 ， 我 所 进行 的 一 个 项 目 需 要 在 HP-UX 系 统 上 部 署 一 个 图 形 用 户 界面 ， 但 


我 的 老板 却 同时 希望 在 几 周 后 的 一 个 内 部 展示 会 上 通过 Windows3.1 掌 上 电脑 
来 进行 一 些 演示 。 因 此 ， 我 开始 搜寻 跨 平 台 的 C++ GUI 开发 包 来 进行 原型 开 
发 。 在 那个 时 候 ， 因 为 没有 Google， 要 完成 这 样 的 工作 实 非 易 事 。 但 我 还 是 发 
现 了 一 些 商业 化 的 可 选 开 发 包 (今天 已 经 无 一 幸存 ) 和 大 量 的 免费 开发 包 。 


当 我 正在 评估 分 析 哪个 免费 开发 包 符 合 当 前 的 紧急 需求 ， 并 决定 哪个 商业 产品 
能 够 满足 我 们 的 长 期 需求 时 ， 我 偶然 看 到 了 wxWidgets 网 站 的 术语 “Python 绑 
定 ”( 这里“ 绑 定 ”一 词 指 Python 语言 和 wxwidgets 开发 包 之 间 的 联系 。) 由 
于 对 如 何 将 软件 开发 包 “ 绑 定 ? 到 假 虫 动物 〈 在 此 之 前 ， 我 从 来 没有 听 说 过 
Python 语言 ) 充满 好 奇 ， 我 顺 着 这 个 链接 一 个 个 的 点 击 ， 直 到 看 到 “Python 1.2 
入 门 文档 ”。 三 个 小 时 后 ， 我 从 当地 的 C++ 倡导 者 变 成 了 Python 的 传播 者 ， 不 断 
忠 扰 周边 的 开发 者 ， 向 他 们 展示 我 的 最 新 发 现 。 


我 开始 和 芬兰 的 Harri Pasanen 一 起 致力 于 推进 Python 和 wxWidgets 的 
ME (在 Edward Zimmerman 的 协助 下 ， 最 终 形成 了 众所周知 

的 wxPython 0.2 ) ， 而 不 是 继续 我 的 原型 开发 。 发 行 声 明 的 邮件 列表 归档 
于 此 处 我 们 使 它 的 功能 强大 到 多 足以 让 我 能 够 用 python 为 老板 建造 一 个 原 
型 。 但 是 wxPython 的 维护 和 改进 工作 却 是 一 个 恒 梦 ， 因 为 每 件 事情 ( 包 

括 C++ 扩展 模块 代码 、 Python 代理 模块 、 编 译 系统 等 等 ) 都 是 手工 完成 
的 ，wxWidget 的 一 点 点 改进 都 会 导致 要 修改 多 处 wxPython 代码 ， 以 确 
保 wxPython 得 到 改进 或 修订 。 当 代码 增加 上 几 万 行 时 ， 这 种 工作 方式 变 得 非 
常 笨拙 和 琐碎 。 另 一 个 客观 事实 是 : 缺乏 一 个 中 心 源 代码 库 ( 那 

是 SourceForge 出 现 之 前 的 时 代 ) ， 因 此 我 们 不 得 不 通过 电子 邮件 互相 发 送 
代码 更 新 ， 你 可 以 想象 得 到 这 其 中 的 难度 。 


大 约 在 此 时 ， 我 不 得 不 “ 丨 正 " 开 始 主 项 目的 开发 了 。 在 我 的 支配 下 ， 项 目 开发 

者 们 一 起 进行 设计 会 晤 、 设 定 开 发 期 限 ， 从 眼中 的 灵光 一 现 开 始 ， 完 成 整个 项 
目的 开发 。 尽 管 还 可 以 用 Python 来 进行 一 些 编译 及 项 目的 测试 脚本 ， 我 发 现 
自己 又 完全 回 到 了 ce 世界 。 Harri 也 无 法 在 上 面 投入 任何 时 间 了 ， 

此 wxPython 的 开发 变 得 比 “ 恨 行 "还 慢 ， 有 时 甚至 进入 了 停滞 状态 。 


1997 年 ， 我 发 现 了 SWIG (简单 封装 和 接口 产生 器 ) ， 并 意识 到 它 可 以 帮助 
我 们 解决 wxPython 项 目 中 困扰 已 久 的 所 有 维护 问题 。 在 三 、 四 周 的 业余 时 间 
里 ， 通 过 使 用 SWIG ， 我 几乎 将 wxPython 的 全 部 重新 实现 了 一 遍 ， 而 在 此 
前 用 手工 完成 这 项 工作 耗 用 了 我 几 周 的 全 天 时 间 以 及 Harri 几 个 月 的 兼职 时 间 。 
在 转向 其 他 项 目 一 段 时 间 后 ， 我 发 现 wxWidgets 2.0 正在 积极 开发 中 ， 而 且 
有 了 一 个 全 新 的 架构 ， 因 此 我 不 得 不 重新 完成 这 项 工作 。 但 这 次 ， 新 的 架构 简 


化 了 大 量 的 工作 ， 我 仅 用 了 一 周 的 业余 时 间 就 完成 了 ! 因此 ， 在 1998 年 夏天 ， 
第 一 个 “现代 版 本 "的 wxPython 顺 利 发 布 ， 并 从 此 一 直 处 于 活跃 开发 状态 。 第 一 
份 声明 归档 于 : 此 处 正如 他 们 所 说 的 ， 剩 下 的 部 分 就 是 传奇 故事 了 。 


必须 特别 说 明 的 是 : SWIG 使 得 我 能 够 轻松 创建 和 维护 成 千 上 百 行 的 代码 ， 
因此 wxPython 的 多 种 功能 特性 必须 感谢 David Beazley 以 及 其 他 项 目 参 与 
者 对 SWIG 的 贡献 。 


通过 此 书 ， 我 们 布 望 能 够 与 您 分 享 对 于 wxPython 的 热情 ， 在 轻松 开发 图 形 用 户 界 
面 应 用 程序 方面 ， 它 是 站 正 的 独一无二 的 开发 包 。 我 们 写作 的 初 隧 是 不 但 为 初学 
者 ， 也 为 专业 人 员 建 造 一 项 有 用 的 资源 。 
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1. 关于 本 书 
i 谁 应 该 阅读 本 书 ? 
ji, 本 书 是 如 何 组 织 的 ? 


ij， 如 何 使 用 本 书 
ii, 印刷 约定 
iii, RÆ T AX 
iv. 从 何 处 获得 更 多 帮助 
v. 作者 在 线 
iii， 关 于 书 名 


iv， 关 于 封面 绘图 
谁 应 该 阅读 本 书 ? 


很 自然 ， 我 们 希望 每 个 人 都 阅读 本 书 。 如 果 你 正在 书店 阅读 本 书 ， 并 在 考虑 是 否 购 
买 它 ， 我 们 会 说 :“ 买 下 它 ! 给 你 们 身边 的 人 也 买 一 本 ， 他 们 今后 将 会 感谢 你 。” 


也 就 是 说 ， 我 们 撰写 本 书 时 ， 我 们 头脑 中 对 于 读者 您 做 了 一 定 的 假设 。 我 们 假设 您 
不 需要 我 们 解释 Python 编程 语言 的 基础 。 在 书 中 ， 我 们 提供 了 大 量 

的 Python 代码 。 尽 管 我 们 认为 Python 代码 非常 好 懂 ， 但 我 们 还 是 认为 必须 现 
在 就 让 您 知道 在 书 中 我 们 没有 提供 关于 Python 基础 的 入 门 指南 。 如 果 您 需要 一 

份 Python 指南， 我 们 向 您 推荐 Manning 出 版 的 (The Quick Python Book) ， 
该 书 由 Daryl Harms 和 Kenneth McDonald 编写 。 


同时 我 们 也 假设 您 至 少 对 描述 图 形 界面 对 象 的 基本 术语 有 所 熟悉 ， 并 从 用 户 角 度 对 
图 形 界面 有 个 大 概 的 了 解 。 至 于 更 加 高 级 的 用 户 界面 概念 ， 或 者 那些 不 常见 的 用 户 
显示 元 素 ， 我 们 会 在 用 到 的 时 候 加 以 详 述 。 


我 们 并 没有 假设 您 之 前 就 掌握 wxPython 相 关 知 识 。 如 果 您 之 前 就 接触 过 
wxPython， 我 们 仍然 希望 您 从 本 书 中 能 够 找到 新 的 信息 ， 或 者 至 少 您 会 发 现 本 书 是 
比 现 有 在 线 文档 更 加 有 用 的 资源 。 


本 书 是 如 何 组 织 的 ? 


我 们 将 《 活 学 活用 wxPython》 分 成 了 三 个 部 分 。 第 一 部 分 简要 介绍 wxPython 的 
相关 概念 ， 并 指导 读者 开始 运用 wxPython， 同 时 还 提供 了 一 些 wxPython 最 佳 实践 
的 信息 。 第 一 部 分 的 章节 包括 : 


e 第 一 章 欢迎 使 用 wxPython 在 该 章节 中 ， 我 们 对 wxPython 进 行 介绍 ， 并 解释 
为 什么 说 它 是 自 切片 面包 以 来 最 伟大 的 事务 ， 同 时 还 提供 了 用 于 创建 wxPython 
的 一 些 技术 背景 资料 。 


第 二 章 给 wxPython 程 序 一 个 坚实 的 基础 讨论 了 wxPython 中 最 重要 的 两 个 对 
象 。 每 个 应 用 程序 都 必须 有 一 个 应 用 程序 对 象 和 一 个 顶级 窗口 。 该 章 将 展示 如 
何 启 动 一 个 wxPython 程 序 ， 以 及 如 何 管 理 它 的 生命 周期 。 


第 三 章 在 事件 驱动 环境 中 开发 wxPython 中 的 控制 是 通过 事件 进行 管理 的 。 该 
章 讨 论 的 是 如 何 处 理事 件 (Event) ， 以 及 如 何 让 它们 像 钧 子 一 样 驱动 功能 。 


第 四 章 使 用 PyCrust 让 wxPython 更 易于 处 理 PyCrust 是 用 wxPython 创 建 
的 一 种 Python 外 壳 ， 包 括 了 许多 高 级 和 有 用 的 特性 。 你 不 仅 可 以 使 

用 PyCrust 来 进行 wxPython 开 发 ， 你 也 可 以 将 程序 封装 于 其 中 来 进行 调试 ， 
而 且 也 可 以 在 自己 的 应 用 中 对 PyCrust 进行 复 用 。 


PLE 创建 蓝图 该 章 讨 论 了 在 GUI 编程 者 经 常 遇 到 困难 的 领域 内 的 三 个 最 佳 实 
践 。 我 们 展示 了 如 何 通 过 重 构 (refactoring ) 来 提升 代码 的 结构 和 可 维护 性 。 
通过 对 Model/View/Controller 设计 模式 的 探索 ， 我 们 展示 了 如 何 对 GUI 代码 进 
行 单元 测试 来 将 错误 减少 化 。 


第 六 章 使 用 基础 构建 块 该 章 是 第 一 部 分 和 第 二 部 分 的 一 座 桥梁 。 在 已 经 展示 
的 基础 思想 上 ， 我 们 通过 构建 一 个 画板 应 用 对 第 二 、 三 部 分 将 要 讨论 的 特性 进 
行 了 一 些 提示 。 


第 二 部 分 开始 了 本 书 更 加 细节 的 部 分 。 第 二 部 分 中 的 章节 讨论 wxPython 中 最 常用 的 
部 分 内 容 。 这 些 章节 包括 了 对 基础 构件 集合 的 入 门 介绍 ， 讨 论 了 标准 窗 体 和 对 话 
框 ， 以 及 对 绘图 和 布局 的 相关 信息 。 第 二 部 分 中 的 章节 和 包括 : 


e 第 七 章 使 用 基本 控件 该 章 禾 盖 了 基本 构件 集合 的 API 函 数 ， 包 括 文本 框 、 按 
钮 、 列 表 框 等 等 。 


第 八 章 将 构件 放 入 窗 体 所 有 的 wxPython 构 件 都 必须 放置 在 窗 体 或 对 话 框 中 。 
该 章 覆 盖 了 窗 体 如 何 运 作 、 有 哪 几 类 窗 体 、 如 何 管理 窗 体 中 的 构件 。 


BILE 使 用 对 话 框 给 用 户 选择 对 话 框 的 行为 方式 和 窗 体 的 略为 不 同 。 我 们 在 
该 章 中 讲述 了 模式 对 话 框 以 及 标准 预定 以 wxPython 对 话 框 如 何 工作 。 我 们 同时 
也 展示 如 何 使 用 wxPython 校 验 器 来 帮助 管理 对 话 框 中 的 数据 。 


第 十 章 创建 和 使 用 WXxPython 菜 单 多 数 窗口 应 用 程序 具备 菜单 。 我 们 将 展示 如 
何 向 菜单 栏 添加 菜单 ， 以 及 如 何 向 菜单 中 加 入 菜单 项 。 同 时 也 包含 了 特殊 菜 
单 ， 比 如 检查 框 、 无 线 菜单 等 内 容 。 我 们 也 将 讨论 了 键盘 快捷 键 和 高 效 使 用 菜 
单 的 有 用 的 指引 。 


第 十 一 章 使 用 尺寸 管理 器 放置 构件 在 wxPython 中 ， 尺 寸 管理 器 (sizers) 被 
用 来 减轻 手工 放置 构件 这 件 苦 差 事 带 来 的 痛苦。wxPython 中 有 多 个 有 用 的 尺寸 
管理 器 ， 我 们 将 向 您 展示 如 何 使 用 它们 ， 以 及 哪 种 布局 最 适合 哪个 管理 器 。 


第 十 二 章 维护 基本 图 形 图 像 任何 图 形 界 面 的 基本 目标 都 是 在 屏幕 上 画 线 和 形 
状 。 在 wxPython 中 ， 有 一 系列 的 可 用 画图 工具 可 供 使 用 。 同 时 还 有 一 个 叫做 设 
备 背景 (device context) 的 强大 的 抽象 概念 ， 它 使 得 我 们 可 以 向 目标 作 图 ， 而 
不 考虑 目标 是 窗口 、 打 印 机 还 是 文件 。 
第 三 部 分 包括 了 对 WxPython 更 加 深入 部 分 的 细节 讨论 。 它 首先 对 三 个 最 复杂 的 
wxPython 进 行 了 描述 ， 随 后 讨论 了 不 同 的 打印 和 显示 机 制 ， 最 后 对 一 些 不 值得 单独 
设立 章节 的 有 用 事务 进行 了 简要 介绍 。 第 三 部 分 的 章节 包括 : 


e 第 十 三 章 构建 列表 控制 和 管理 列表 项 WxPython 的 列表 控件 给 了 我 们 以 图 标 模 
式 、 列 表 模式 或 多 列 报告 模式 显示 "浏览 风格 "列表 的 能 力 。 你 也 可 以 定义 排序 
行为 ， 并 允许 用 户 对 列表 条 目 进行 编辑 。 


第 十 四 章 ， 调 整 网 格 控 件 如 果 你 需要 像 电 子 表格 一 样 的 东西 ，WXPython 的 网 
格 控件 是 符合 你 需求 的 完整 功能 构件 。 它 允许 对 网 格 显示 和 行为 的 彻底 控制 ， 
并 允许 完全 的 自 定义 配置 。 


第 十 五 章 Oe Lb EAE wxPython 树 型 控件 使 得 我 们 可 以 对 分 等 级 的 数据 进 
行 紧凑 显示 ， 包 括 但 不 限于 目录 树 或 者 类 的 继承 关系 。 你 也 可 以 允许 用 户 任意 
对 条 目 进行 编辑 。 


第 十 六 章 向 wxPython 应 用 程序 中 并 入 HTML 在 wxPython 中 ， 你 可 以 使 用 
HTML 来 简化 格式 化 文本 的 显示 和 打印 。wxPython 中 的 HTML 引 擎 可 以 定义 以 
用 于 满足 特殊 需求 。 


第 十 七 章 wxPython 打 印 框 架 体 系 wxPython 中 的 打印 通过 一 些 专门 的 打印 、 
打印 数据 和 打印 预览 对 象 来 进行 管理 。 在 该 章 中 ， 我 们 对 它们 如 何 一 起 工作 进 
行 了 探索 。 

第 十 八 章 使 用 其 他 WXPython 功 能 在 该 章 中 ， 我 们 讲述 了 一 些 重要 的 特性 ， 它 
们 还 没有 长 到 可 以 单独 设立 章 列 的 地 步 ， 包 括 剪 切 、 粘 贴 、 拖 放 和 多 线程 。 


如 何 使 用 本 书 


如 何 使 用 本 书 取 决 于 您 对 wxPython 的 掌握 了 解 程度 我 们 对 本 书 的 策划 目标 是 要 对 专 
家 和 初学 者 都 有 所 帮助 ， 但 也 希望 不 同 层次 的 用 户 对 本 书 的 不 同 部 分 都 有 或 多 或 少 
有 所 共鸣 。 


回顾 。 第 五 章 介绍 如 何 让 代码 更 易于 管理 的 方法 ， 第 四 章 提 供 了 一 些 协助 进行 调 
试 、 编 写 wxPython 应 用 的 工具 。 当 你 开始 编写 自己 的 wxPython 程 序 时 ， 你 就 已 经 
开始 使 用 第 二 部 分 讨论 的 API 了 一 我们 试图 按照 功能 进行 组 织 章节 内 容 ， 以 方便 
您 查找 有 用 的 主题 。 


如 果 您 对 wxPython 已 经 熟悉 了 ， 你 可 能 将 时 间 主 要 花 在 第 二 部 分 和 第 三 部 分 之 上 。 
然而 ， 我 们 依然 推荐 您 快速 阅读 一 遍 第 一 部 分 。 如 果 您 不 熟悉 Pycrust ， 第 四 章 
对 您 来 说 就 是 新 内 容 了 ， 我 们 相信 在 第 五 章 中 您 也 能 找到 一 些 有 用 的 内 容 。 


在 第 三 部 分 ， 您 将 会 发 现 一 些 更 加 复杂 的 构件 的 讨论 ， 您 将 发 现 这 些 章节 中 的 代码 
比 其 他 章节 中 的 更 长 也 更 加 完整 。 本 书 中 的 这 些 例子 都 是 基于 Python 2.3.x 编 写 的 
一 一 我 想 我 们 没有 包括 所 有 Python 2.4 和 wxPython 2.5 中 的 新 特性 。wxPython 
2.6.x 版 本 发 布 比较 迟 了 ， 因 此 本 书 无 法 涵盖 其 内 容 。 然 而 ， 它 确实 包含 了 大 量 的 
BUG 补 丁 和 对 wxWidgets 的 有 限 兼容 。 


正式 开始 之 前 ， 还 有 一 点 我 们 必须 指明 。 那 就 是 本 书 并 不 准备 事 无 巨细 地 提供 
WXxPython 的 所 有 内 容 的 参考 。 我 们 期 望 本 书 能 够 为 您 需要 知道 的 所 有 功能 特性 提供 
参考 ， 但 它 确实 没有 100% 履 盖 所 有 的 特性 。 出 于 时 间 和 空间 的 考虑 ， 我 们 不 得 不 
选择 将 重点 放 在 某 些 元 素 上 ， 而 其 他 的 一 些 则 无 法 详细 介绍 。 例 如 ， 有 一 些 从 C++ 


wxWidgets 中 继承 的 wxPython 特 性 在 标准 Python 库 中 得 到 了 复制 ， 对 于 这 些 特性 我 
们 选择 不 在 本 书 中 涵盖 。 同 时 ， 如 果 你 使 用 了 1990 年 代 的 Windows 操 作 系 统 ， 您 可 
能 会 发 现 一 些 例子 中 的 特性 并 非 如 所 描述 的 那样 起 工作 ， 在 此 我 们 没有 足够 的 空间 
枚 举 出 这 些 例外 。 最 后 ， 有 一 些 核 心 构件 集合 的 特性 我 们 认为 并 不 经 常用 到 ， 因 此 
我 们 也 没有 空间 公平 对 待 它们 。 


印刷 约定 
本 书 中 始终 使 用 一 下 约定 : 


Courier 字体 使 用 在 所 有 代码 列表 中 

ltalics 字体 用 来 介绍 新 术语 

Courier Bold 字体 有 时 用 来 吸引 您 对 部 分 代码 的 注意 。 

代码 注释 用 来 将 您 的 注意 力 指向 特定 的 代码 行 注释 采用 句点 标记 ， 比 如 b. 
Courier 字体 用 于 代码 中 的 文本 ，wxPython 类 和 方法 名 称 ， 或 者 Python 代 码 片 


B 


代码 下 载 


本 书 中 使 用 的 所 有 例子 的 源 代码 可 以 从 出 版 商 的 网 站 
http://www.manning.com/rappin 下 载 。 


从 何 处 获得 更 多 帮助 

虽然 我 们 尽 可 能 地 让 本 书 易 于 理解 ， 但 我 们 不 可 能 预见 您 你 在 使 用 wxPython 过 程 中 
可 能 预见 的 所 有 用 法 和 问题 。 

wxPython 的 主 站 http://www.wxpython.org 有 一 些 资 源 也 许可 以 帮助 您 解决 问题 。 
官方 在 线 文档 位 置 为 : wxpython.org/docs/api/ 

在 http://wiki.wxpy-thon.org/ 有 一 个 互助 wiki 网站， 当然 你 也 可 以 订 

阅 http://www.wxpy-thon.org/maillist.php 处 的 邮件 列表 。 


作者 在 线 


也 可 以 从 作者 在 线 论坛 获取 帮助 ， 这 是 一 个 由 Manning 出 版 商 提 供 的 私人 网 页 论 
坛 。 您 可 以 通过 该 论坛 对 本 书 进 行 评论 ， 咨 询 技术 问题 ， 接 受 来 自作 者 或 其 他 读者 
的 帮助 。 使 用 浏览 器 访问 http://www.man-ning.com/rappin 可 获取 这 些 免 费 服务 。 论 
坛 的 欢迎 页 面 给 出 了 注册 和 其 他 行为 所 需 的 所 有 信息 。 作 者 在 线 论 坛 ( Author 
Online forum) 是 Manning 始 终 忠 于 读者 的 表现 方式 之 一 。 作 者 对 论坛 中 的 参与 是 
完全 资源 的 ， 没 有 任何 特定 级 别 的 义务 性 。 论 坛 是 与 他 人 分 享 思路 和 向 他 人 学 习 的 
好 途径 。 主 要 本 书 仍 在 销售 中 ， 就 可 以 出 版 商 的 网 站 进入 作者 在 线 论坛 。 


关于 书 名 


通过 组 合 介 绍 、 回 顾 和 "如何" 例子 ，“ 活 学 活用 ”书籍 设计 意图 是 帮助 学 习 和 记忆 。 按 
照 认 知 科学 的 研究 成 果 ， 人 们 记 住 的 事物 是 他 们 在 自主 探索 中 获得 的 事物 。 尽 

管 Manning 公司 没有 谁 是 认 知 科学 家 ， 但 我 们 确信 和 要 想 让 所 学 变 成 永久 财富 ， 必 
须 经 历 探索 、 实 际 动手 操作 ， (有 趣 地 是 还 包括 ) 对 所 学 内 容 的 重 述 等 步骤 。 人 们 
对 新 事务 进行 理解 和 记忆 ， 也 就 是 说 只 有 在 积极 探索 之 后 ， 人 们 才 会 掌握 它们 。 人 
们 总 是 在 使 用 的 过 程 中 学 习 。"“ 活 学 活用 ”引导 的 基本 部 分 是 实例 驱动 的 。 它 鼓励 读 
者 自己 尝试 ， 对 新 代码 实际 操作 以 及 探索 新 的 思路 。 对 于 本 书 的 书 名 来 说 ， 还 有 一 
条 更 加 通俗 的 理由 ， 我 们 的 读者 都 很 忙碌 。 他 们 使 用 书籍 往往 是 为 了 完成 某 项 工作 
或 解决 某 个 问题 。 他 们 需要 的 书籍 能 够 允许 他 们 自由 跳跃 式 阅读 ， 只 在 需要 某 个 知 
识 点 的 时 候 才 对 它 进行 学 习 。 他 们 需要 书籍 使 自己 处 于 “运转 ”状态 。 该 系列 的 书籍 
是 为 这 样 的 读者 设计 的 。 


关于 封面 绘 


《 活 学 活用 wxPython》 一 书 的 封面 图 形 为 "Soldat Japonais”， 一 名 日 本 士兵 。 该 插 
图 取 自 1796 年 法 国 出 版 的 由 3. G. St. Saveur 所 著 的 法 文 旅游 书 

夭 Encyclopedie des Voyages) 。 在 那个 时 候 ， 为 寻求 快乐 而 旅行 还 是 个 相 
对 新 鲜 的 现象 ， 像 该 书 一 样 的 旅游 指南 非常 受 欢迎 ， 它 不 仅 介绍 了 旅程 者 自己 ， 还 
反映 了 民意 的 旅行 者 前 往 法 国 其 他 地 区 及 国外 居住 地 的 见闻 。 


(Encyclopedie des Voyages) 一 书 中 多 样 的 插图 生动 地 反映 了 200 多 年 前 世界 
各 地 的 城镇 和 省 份 的 独特 和 个 性 。 这 个 时 代 ， 两 个 相隔 仅 数 英里 的 地 区 会 通过 服饰 
代码 来 区 分 人 所 属地 。 这 本 旅行 指南 在 狂热 的 现实 中 唤醒 了 我 们 关于 那个 时 代 及 其 
他 历史 时 期 的 那 种 与 世 隔 绝 的 感受 。 


那个 年 代 之 后 ， 服 饰 代码 已 经 发 生变 化 ， 地 区 差异 也 随时 代 变 迁 逐 渐 和 褪色。 现在 ， 
我 们 经 常会 很 难 区 分 居住 不 同 大 洲 的 居民 。 也 许 ， 乐 观点 来 说 ， 我 们 已 经 将 文化 、 
可 见 差异 与 更 加 多 样 性 的 个 体 生 活 做 了 一 次 交易 。 或 者 说 一 个 更 多 样 的 充满 趣味 的 
的 理性 、 技 术 性 生活 。 在 Manning ， 我 们 通过 该 旅行 指南 中 的 图 片 将 两 个 世纪 之 
前 地 区 生活 间 的 丰富 差异 带 回 现实 ， 以 此 赞美 计算 机 商业 的 独创 性 、 能 动 性 与 乐趣 
性 。 


第 一 章 欢迎 使 用 wxPython 


欢迎 使 用 wxPython 
i. Bac eed 
i 创建 最 小 的 空 的 wxPython 程 序 
i. eee ee 
ii， 使 用 应 用 程序 和 框架 工作 
il. 扩展 这 个 最 小 的 空 的 wxPython 程 序 
iv. 创建 最 终 的 hello.py 程 序 


下 面 是 一 个 例子 ， 它 创建 了 一 个 有 一 个 文本 框 的 窗口 用 来 显示 鼠标 的 位 置 。 


#!/bin/env python 
import wx 
class MyFrame(wx.Frame): 


def _ init (self): 
wx.Frame.__init__(self, None, -1, "My Frame", size=(300, 
300) ) 
panel = wx.Panel(self, -1) 
panel.Bind(wx.EVT MOTION, self.OnMove) 
wx.StaticText(panel, -1, "Pos:", pos=(10, 12)) 
self.posCtrl = wx.TextCtrl(panel, -1, "", pos-(40, 10)) 


def OnMove(self, event): 
pos - event.GetPosition() 
self.posCtrl.SetValue("96s, 96s" 96 (pos.x, pos.y)) 
if name == ' main ': 
app - wx.PySimpleApp() 
frame - MyFrame() 
frame.Show(True) 
app.MainLoop() 


图 示 如 下 : 
ED 
Pos: fise, 85 


漂亮 的 界面 是 一 个 GUI 程序 必 不 可 少 的 一 部 分 ， wxPython 可 以 做 到 这 一 点 ， 加 
之 Python 强大 的 功能 和 简洁 的 语法 ， 使 用 得 它 在 Python 的 gui 中 成 为 一 种 主 


A 


第 一 章 欢迎 使 用 wxPython 


开始 WwxPython 

首先 我 们 创建 一 个 显示 一 个 图 像 的 文件 。 这 将 分 三 步 : 
1. 首先 创建 一 个 空 的 最 小 的 可 以 工作 的 wxPthon 程序 
2. 组 织 和 细 化 


3. 显示 wxPython 的 logo 
图 示 如 下 : 


Figure 1.2 
Running hello.py 
on Windows 





创建 最 小 的 空 的 wxPython 程 序 
我 们 创建 一 个 名 为 bare.py 的 程序 并 键入 以 下 代码 : 


import wx #1 
class App(wx.App) :#2 


def OnInit(self): #3 


frame = wx.Frame(parent=None, title-'Bare') 


frame .Show( ) 
return True 


app = App() #4 
app.MainLoop() #5 


上 面 的 代码 运行 的 结果 如 下 : 


Figure 1.5 
Running bare .py on Windows. 
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上 面 的 代码 的 任何 一 行 都 不 能 少 ， 否 则 将 不 能 工作 。 这 个 基本 的 wxPython 程序 说 
明了 开发 任 一 wxPython 程序 所 必须 的 五 个 基本 步骤 : 


1. 导入 必须 的 wxPython & 
. 子 类 化 wxPython 应 用 程序 类 
. 定义 一 个 应 用 程序 的 初始 化 方法 


2 

3 

4. 创建 一 个 应 用 程序 类 的 实例 

5. 进入 这 个 应 用 程序 的 主事 件 循 环 


下 面 让 我 们 看 看 这 个 最 小 的 空 的 程序 是 如 何 一 步 一 步 实现 的 。 


导入 wxPython 


你 需要 做 的 第 一 件 事 就 是 导入 这 个 主要 的 wxPython 包 ， 这 个 包 名 为 wx: 


import wx 


一 旦 这 个 包 被 导入 ， 你 就 可 以 引用 wxPython WX ` HHS (它们 以 wx A 
MA) > 如 下 所 未 


class App(wx.App): 


注意 : 老 的 引入 方式 仍然 被 支持 ， 你 可 能 会 遇 到 用 这 种 老 的 引入 方式 的 代码 。 因 此 
我 们 将 会 简短 地 说 明 这 种 老 的 方式 及 为 什么 要 改变 它 。 老 的 包 的 名 字 

是 wxPython ， 它 包含 了 一 个 内 在 的 名 为 wx 模块 。 那 时 ， 通 常 有 两 种 导入 必要 
的 代码 的 方法 ， 一 种 就 是 从 wxPython 包 中 导入 wx 模块 : from wxPython 
import wx ; 男 一 种 就 是 直接 从 wx 模块 中 导入 所 有 的 东西 : from 
wxPython.wx import 。 这 两 种 方法 都 有 严重 的 缺点 。 这 第 二 种 方 

ik Python 中 是 不 建议 使 用 的 ， 这 因为 可 能 导致 名 字 空 间 冲 突 ， 而 老 的 wx 模块 
通过 在 其 属性 前 加 一 个 wx 前 级 避免 了 这 个 问题 。 尽 管 使 用 这 个 安全 防范 ， 但 

是 import 仍然 有 可 能 导致 问题 ， 但 是 许多 wxPython 程序 员 喜 欢 这 种 类 型 ， 并 
且 你 将 在 老 的 代码 中 经 常 看 到 这 种 用 法 。 这 种 风格 的 坏处 是 类 名 以 小 写字 母 开头 ， 
而 大 多 数 wxPython 方法 以 大 写字 母 开 头 ， 这 和 通常 的 Python 编写 程序 的 习惯 
相反 。 


然而 如 果 你 试图 避免 由 于 使 用 import * 导 致 的 名 字 空 间 膨 胀 ， 而 使 用 from 
wxPython import wx 。 那 么 你 就 不 得 不 为 每 个 类 、 函 数 、 常 数 名 键入 两 
次 wx ， 一 次 是 作为 包 的 前 级 ， 另 一 次 是 作为 通常 的 前 级， 例如 wx.wxWindow ° 


对 于 导入 顺序 需要 注意 的 是 : 你 从 wxPython 导入 其 它 东 西 之 前 必须 先导 
入 wx 。 通 常情 况 下 ， Python 中 的 模块 导入 顺序 无 关 。 但 是 wxPython 中 的 不 
同 ， 它 是 一 个 复杂 的 模块 。 当 你 第 一 次 导入 wx 模块 时 ， wxPython 要 对 别 


的 wxPython 模块 执行 一 些 初始 化 工作 。 例 如 wxPython 中 的 一 些 子 包 ， 
如 xrc 模块 ， 它 在 wx 模块 导入 之 前 不 能 够 正确 的 工作 ， 我 们 必须 按 下 面 顺序 导 
^ 


import wx 
from wx import xrc 


以 上 的 导入 顺序 只 针对 wxPython 的 模块 ， Python 的 模块 导入 顺序 没关系 。 例 
如 : 


import sys 

import wx 

import os 

from wx import xrc 
import urllib 


使 用 应 用 程序 和 框架 工作 


一 旦 你 导入 了 wx 模块 ， 你 就 能 够 创建 你 的 应 用 程序 ( application ) 对 象 和 框 
架 ( frame ) 对 象 。 每 个 wxPython 程序 必须 有 一 个 application 对 象 和 至 少 
一 个 frame 对 象 。 application 对 象 必 须 是 wx.App 的 一 个 实例 或 你 

在 OnInit() 方法 中 定义 的 一 个 子 类 的 一 个 实例 。 当 你 的 应 用 程序 启动 的 时 

ik > OnInit() 方法 将 被 wx.App 父 类 调用 。 


子 类 化 wxPython application 类 
下 面 的 代码 演示 了 如 何 定 义 我 们 的 wx.App TR: 


class MyApp(wx.App): 


def OnInit(self): 
frame = wx.Frame(parent=None, id=-1, title="Bare") 
frame.Show() 
return True 


上 面 我 们 定义 了 一 个 名 为 MyApp 的 子 类 。 我 们 通常 在 OnInit() 方法 中 创 

建 frame Ro EMA wx.Frame 接受 三 个 参数 ， 仅 第 一 个 是 必须 的 ， 其 余 的 都 
有 默认 值 。 调 用 Show() 方法 使 frame 可 见 ， 否 则 不 可 见 。 我 们 可 以 通过 

给 Show() 一 个 布尔 值 参 数 来 设 定 frame 的 可 见 性 : 


frame.Show(False) # 使 框架 不 可 见 ， 
frame.Show(True) # True 是 默认 值 ， 使 框架 可 见 ， 
frame .Hide() 4 3H Tframe.Show(False) 


定义 一 个 应 用 程序 的 初始 化 方法 

注意 : 我 们 没有 为 我 们 的 应 用 程序 类 定义 一 个 init () 方法 。 

在 Python 中 ， 这 就 意味 着 父 方法 wx.App. init() 将 在 对 象 创建 时 被 自动 调 
用 。 这 是 一 个 好 的 事情 。 如 果 你 定义 你 自己 的 _init_() 方法 ， 不 要 忘 了 调用 
其 基 类 的 ”init() 方法 ， 示 例如 下 : 


class App(wx.App): 
def _ init (self): 


wx.App.__init__(self) 


如 果 你 忘 了 这 样 做 ， wxPython 将 不 被 初始 化 并 且 你 的 onInit() 方法 也 将 得 不 
到 调用 。 


创建 一 个 应 用 程序 实例 并 进入 它 的 主事 件 循环 
这 步 是 创建 wx.App 子 类 的 实例 ， 并 调用 它 的 MainLoop() 方法 : 


app = App() 
app.MainLoop() 


一 旦 进入 主事 件 循 环 ， 控 制 权 将 转交 给 wxPython 。 wxPython GUI 程序 主要 
eames Bis Fest Bo EP EER OPT ATE RRA > 
个 app.MainLoop() 方法 将 返回 且 程序 退出 。 


扩展 这 个 最 小 的 空 — 


现在 我 们 将 给 空 的 最 小 程序 增加 适当 数量 的 功能 ， 它 包含 了 通常 Python 编程 的 标 
准 并 能 够 作为 你 自己 的 程 


序 的 一 个 基准 。 下 面 我 们 创建 一 个 名 为 spare.py 程序 : 


#!/usr/bin/env python #1 


"""Spare.py is a starting point for a wxPython program.""" #2 
import wx 
class Frame(wx.Frame): #3 

pass 


class App(wx.App): 


def OnInit(self): 
self.frame = Frame(parent=None, title='Spare' ) #4 
self .frame.Show( ) 
self .SetTopwindow(self.frame) #5 
return True 


SHE anc SS ie e: #6 


app = App() 
app .MainLoop( ) 


aN 仍然 很 小 ， SR 但 是 它 增 加 了 几 个 重要 的 项 目 让 我 们 考虑 到 什 
么 样 的 代码 是 好 的 、 完 整 的 。 


#1 这 行 看 似 注释 ， 但 是 在 如 linux 和 unix 等 操作 系统 上 ， 它 告诉 操作 系统 如 何 
找到 执行 该 程序 的 解释 器 。 如 果 这 个 程序 被 给 ey TALE ae chmod 4 
4) ， 我 们 可 以 在 命令 行 下 仅仅 键入 该 程序 的 名 字 来 运行 这 个 程序 : 


% spare.py 


这 行 在 其 它 的 操作 系统 上 将 被 忽略 。 包含 它 可 以 实现 代码 的 跨 平台 。 


42 这 是 文档 字符 串 ， 当 模块 中 的 第 一 名 是 字符 串 的 时 候 ， 这 个 字符 串 就 成 了 该 模块 
的 文档 字符 串 并 存储 


在 该 模块 的 — doc ”属性 中 。 你 能 够 在 你 的 代码 中 、 某 些 开 发 平台 、 基 至 交互 模 
式 下 运行 的 Python 解释 器 


中 访问 文档 字符 串 : 


import spare 
print spare. doc 


Spare.py 简单 wxPython 程序 的 起 点 


#3 我 们 改变 了 你 们 创建 frame 对 象 的 方法 。 bare 版 的 程序 简单 地 创建 了 一 

个 wx.Frame 类 的 实例 。 在 spare 版 中 ， 我 们 定义 了 我 们 自己 的 Frame 类 作 
为 wx.Frame 的 子 类 。 此 时 ， 最 终 的 结果 没有 什么 不 同 ， 但 是 如 果 你 想 在 你 的 框架 
中 显示 诸如 文本 、 按 钮 、 菜 单 的 话 ， 你 可 能 就 想 要 你 自己 的 Frame 类 了 。 

#4 我 们 将 对 frame 实例 的 引用 作为 应 用 程序 实例 的 一 个 属性 

#5 在 OnInit() 方法 中 ， 我 们 调用 了 这 个 App 类 自己 的 SetTopwindow() 7 
法 ， 并 传递 给 它 我 们 新 创建 的 frame 实例 。 我 们 不 必定 义 SetTopWindow() 7 
法 ， 因 为 它 继承 自 wx.App LHe SetTopwindow() 方法 是 一 个 可 选 的 方法 ， 它 
让 wxPython 方法 知道 哪个 框架 或 对 话 框 将 被 认为 是 主要 的 。 一 个 wxPython 程 
序 可 以 有 几 个 框架 ， 其 中 有 一 个 是 被 设计 为 应 用 程序 的 顶级 窗口 的 。 

#6 这 个 是 Python 中 通常 用 来 测试 该 模块 是 作为 程序 独立 运行 还 是 被 另 一 模块 所 
导入 。 我 们 通过 检查 该 模块 的 ”name 属性 来 实现 : 


if name == ' main ': 
app - App() 
app.MainLoop() 


创建 最 终 的 hello.py 程 序 


代码 如 下 : 


#!/usr/bin/env python 
"""Hello, wxPython! program.""" 
import wx 


class Frame(wx.Frame): #2 wx.Frame TX 
"""Frame class that displays an image.""" 


def — init (self, image, parent=None, id--1, 
pos-wx.DefaultPosition, 
title-'Hello, wxPython!'): #3 图 像 参 数 
"""Create a Frame instance and display image.""" 
#4 显示 图 像 
temp = image.ConvertToBitmap( ) 
size = temp.GetWidth(), temp.GetHeight() 
wx.Frame. init (self, parent, id, title, pos, size) 
self.bmp = wx.StaticBitmap(parent-self, bitmap-temp) 


class App(wx.App): #5 wx.App t X 
"""Application class.""" 


def OnInit(self): 
#6 图 像 处 理 
image = wx.Image('wxPython.jpg', wx.BITMAP_TYPE_JPEG) 
self.frame = Frame(image) 


self .frame.Show( ) 
self .SetTopwindow(self.frame) 
return True 


def main(): #7 


app = App() 
app .MainLoop( ) 


if | name == ' main ': 
main() 


说 明 : 
e #2 定义 一 个 wx.Frame 的 子 类 ， 以 便 我 们 更 容量 控制 框架 的 内 容 和 外 观 。 


#3 给 我 们 的 框架 的 构造 器 增加 一 个 图 像 参 数 。 这 个 值 通过 我 们 的 应 用 程序 类 在 
创建 一 个 框架 的 实例 时 提供 。 同 样 ， 我 们 可 以 传递 必要 的 值 


给 wx.Frame. init () 


#4 我 们 将 用 wx.StaticBitmap 控件 来 显示 这 个 图 像 ， 它 要 求 一 个 位 图 。 所 
以 我 们 转换 图 像 到 位 图 。 我 们 也 使 用 图 像 的 宽度 和 高 度 创建 一 个 size 元 组 。 
这 个 size 元 组 被 提供 给 wx.Frame. init () 调用 ， 以 便于 框架 的 尺寸 匹 
配 位 图 尺寸 。 


#5 定义 一 个 带 有 onrnit() 方法 的 wx.App 的 子 类 ， 这 是 wxPython 应 用 程 
序 最 基本 的 要 求 。 


#6 我 们 使 用 与 hello.py 在 同一 目录 下 的 名 为 wxPython.jpg 的 文件 创建 了 
一 个 图 像 对 象 。 


#7 main() 函数 创建 一 个 应 用 程序 的 实例 并 尼 动 wxPython 的 事件 循环 。 


第 二 章 给 wxPython 程 序 一 个 坚实 的 基础 


1. 给 你 的 wxPython 程 序 一 个 稳固 的 基础 
L 关于 所 要 求 的 对 象 我 们 需要 知道 些 什 么 ? 
ii， 如 何 创 建 和 使 用 一 个 应 用 程序 对 象 ? 
i， 创 建 一 个 wx.App 的 子 类 
ii， 理 解 应 用 程序 对 象 的 生命 周期 
诈 ， 如何 定 向 wxPython 程 序 的 输出 ? 
i， 重 定向 输出 
ji， 修改 默认 的 重 定 向 行为 
iv. 如 何 关闭 wxPython 应 用 程序 ? 
ij， 管理 正常 的 关闭 
ii， 管 理 紧 急 关闭 
v. 如 何 创 建 和 使 用 顶级 窗口 对 象 ? 
i， 使 用 wx.Frame 
ii 使 用 wxPython 的 ID 
iii， 使 用 wx.Size 和 wx.Point 
iv. 使 用 Wx.Frame 的 样式 
Vi， 如 何 为 一 个 框架 增加 对 象 和 子 窗 口 ? 
ji， 给 框架 增加 窗口 部 件 
让 ， 给 框架 增加 菜单 栏 、 工 具 栏 和 状态 栏 。 
Vii， 如 何 使 用 一 般 的 对 话 框 ? 
viii， 一 些 最 常见 的 错误 现象 及 解决 方法 ? 
ix. 总结 


JE 


房屋 的 基础 是 混凝土 结构 ， 它 为 其 余 的 建造 提供 了 坚固 的 基础 。 你 的 wxPython 程 
序 同 样 有 一 个 基础 ， 它 由 两 个 必要 的 对 象 组 成 ， 用 于 支持 你 的 应 用 程序 的 其 余部 
分 。 它 们 是 应 用 程序 对 象 和 顶级 窗口 对 象 。 适 当地 使 用 这 两 个 对 象 将 给 你 

的 wxPython 应 用 程序 一 个 稳固 的 开始 并 使 得 构造 你 的 应 用 程序 的 其 余部 分 更 容 


易 。 


关于 所 要 求 的 对 象 我 们 需要 知道 些 什么 ? 


让 我 们 来 说 明 一 下 这 两 个 基础 对 象 。 应 用 程序 对 象 管 理 主事 件 循 环 ， 主 事件 循环 是 
你 的 wxPython 程序 的 动力 。 局 动 主事 件 循 环 是 应 用 程序 对 象 的 工作 。 没 有 应 用 程 
序 对 象 ， 你 的 wxPython 应 用 程序 将 不 能 运行 。 顶级 窗口 通常 管理 最 重要 的 数 

据 ， 控 制 并 呈现 给 用 户 。 例 如 ， 在 词 处 理 程序 中 ， 主 窗口 是 文档 的 显示 部 分 ， 并 很 
可 能 管理 着 该 文档 的 一 些 数据 。 类 似 地 ， 你 的 web 浏览 器 的 主 窗口 同时 显示 你 所 
关注 的 页 面 并 把 该 页 作为 一 个 数据 对 象 管理 。 下 图 显示 了 这 两 个 基础 对 象 和 你 的 应 
用 程序 的 其 它 部 分 这 间 的 关系 : 
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Figure 2.1 A schematic of the basic wxPython application 
structure, showing the relationship between the application 
object, the top-level window, and the main event loop 


如 图 所 示 ， 这 个 应 用 程序 对 象 拥 有 顶级 窗 口 和 主事 件 循环 o 顶级 窗口 管理 其 窗口 中 
的 组 件 和 其 它 的 你 分 配给 它 的 数据 对 象 。 窗口 和 它 的 组 件 的 触发 事件 基于 用 户 的 动 
作 ， 并 接受 事件 通知 以 便 改 变 显 示 。 


如 何 创 建 和 使 用 一 个 应 用 程序 对 和 象 ? 


任何 wxPython 应 用 程序 都 需要 一 个 应 用 程序 对 象 。 这 个 应 用 程序 对 象 必 须 是 

类 wx.App 或 其 定制 的 子 类 的 一 个 实例 Pen ren nen aus, 
事件 循环 。 这 个 事件 循环 响应 于 窗口 系统 事件 并 分 配 它们 给 适当 的 事件 处 理 器 

个 应 用 程序 对 象 对 wxPython 进程 的 管理 如 此 的 重要 以 至 于 在 你 的 程序 没有 实例 化 
一 个 应 用 程序 对 象 之 前 你 不 能 创建 任何 的 wxPython 图 形 对 象 。 


RE wx.App 也 定义 了 一 些 属 性 ， 它 们 对 整个 应 用 程序 是 全 局 性 的 。 很 多 时 候 ， 它 
们 就 是 你 对 你 的 应 用 程序 对 象 所 需要 的 全 部 东西 。 假 如 你 需要 去 管理 另外 的 全 局 数 
据 或 连接 (如 一 个 数据 库 连 接 ) ， 你 可 以 定制 应 用 程序 子 类 。 在 某 些 情况 下 ， 你 可 
能 想 为 专门 的 错误 或 事件 处 理 而 扩展 这 个 主事 件 循 环 。 然 而 ， 默 认 的 事件 循环 几乎 
适合 所 有 的 你 所 要 写 的 wxPython 应 用 程序 。 


创建 一 个 wx.App 的 子 类 


创建 你 自己 的 wx.App 的 子 类 是 很 简单 的 。 当 你 开始 你 的 应 用 程序 的 时 候 ， 创 建 你 
自己 的 wx.App 的 子 类 通常 是 一 个 好 的 想法 ， 即 使 是 你 不 定制 任何 功能 。 创 建 和 使 
用 一 个 wx.App 子 类 ， 你 需要 执行 四 个 步骤 : 


1、 定 义 这 个 子 类 2、 在 定义 的 子 类 中 写 一 个 OnInit() 方法 3、 在 你 的 程序 gue 
要 部 分 创建 这 个 类 的 一 个 实例 4、 调 用 应 用 程序 实例 的 MainLoop() 方法 。 这 个 方 
法 将 程序 的 控制 权 转 交 给 wxPython 


我 们 在 第 一 章 中 看 到 过 OnInit() 方法 。 它 在 应 用 程序 开始 时 并 在 主事 件 循环 开始 
前 被 wxPython 系统 调用 。 这 个 方法 不 要 求 参 数 并 返回 一 个 布尔 值 ， 如 果 所 返回 的 
值 是 False ， 则 应 用 程序 将 立即 退出 。 大 多 数 情况 下 ， 你 将 想 要 该 方法 返回 的 结 
果 为 真 。 处 理 某 些 错误 条 件 ， 退 出 可 能 是 恰当 的 方法 ， 诸 如 所 一 个 所 需 的 资源 缺 
Ao 


由 于 OnInit() 方法 的 存在 ， 并 且 它 是 wxPython 架构 的 一 部 分 ， 所 以 任何 关于 
你 的 定制 的 类 的 所 需 的 初始 化 通常 都 由 OnInit() 方法 管理 ， 而 不 

在 Python 的 init 方法 中 。 如 果 由 于 茶 些 原因 你 决定 需要 init 方 
法 ， 那 么 你 必须 在 你 的 init _ 方法 中 调用 父 类 的 — init _ 方法， 如 下 所 
示 : 


wx.App. init (self) 


通常 ， 你 在 onInit() 方法 中 将 至 少 创建 一 个 框架 对 象 ， 并 调用 该 框架 
的 Show() 方法 。 你 也 可 以 有 选择 地 通过 调用 SetTopWindow() 方法 来 为 应 用 程 
序 指 定 一 个 框架 作为 顶级 窗口 。 顶 级 窗口 被 作为 那些 没有 指定 父 窗 口 的 对 话 框 的 默 
认 父 窗口 。 


何 时 省 略 wx.App 的 子 类 


你 没有 必要 创建 你 自己 的 wx. App 子 类 ， 你 通常 想 这 样 做 是 为 了 能 够 

在 OnInit() 方法 中 创建 你 的 顶级 框架 。 通常， 如 果 在 系统 中 只 有 一 个 框架 的 
话 ， 避 免 创 建 一 个 wx.App 子 类 是 一 个 好 的 主意 。 在 这 种 情况 下 ， wxPython 提 
供 了 一 个 方便 的 类 wx.PySimpleApp 。 这 个 类 提供 了 一 个 最 基本 的 OnInit() 方 
ik* wx.PySimpleApp 类 定义 如 下 : 


class PySimpleApp(wx.App): 


def _ init__(self, redirect=False, filename=None, 
useBestVisual=False, clearSigInt=True): 
wx.App. init (self, redirect, filename, useBestVisual, 
clearSigInt) 


def OnInit(self): 
return True 


下 面 是 wx.PysimpleApp 一 个 简单 用 法 : 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = MyNewFrame (None) 
frame.Show(True) 
app.MainLoop() 


在 上 面 这 段 代 码 的 第 一 行 ， 你 创建 了 一 个 作为 wx. PySimpleApp 的 实例 的 应 用 程 
序 对 象 。 由 于 我 们 在 使 用 wx.PySimpleApp 类 ， 所 以 我 们 没有 定制 OnInit 方 
法 。 第 二 行 我 们 定义 了 一 个 没有 父亲 的 框架 ， 它 是 一 个 顶级 的 框架 。 (很 显然 ， 这 
个 MyNewFrame 类 需要 在 别处 被 定义 ) 这 第 三 行 显示 框架 ， 最 后 一 行 调用 应 用 程 
序 主 循环 。 


正如 你 所 看 到 的 ， 使 用 wx.PySimpleApp 让 你 能 够 运行 你 的 wxPython 程序 而 无 
需 创建 你 自己 定制 的 应 用 程序 类 。 如 果 你 的 应 用 程序 十 分 简单 的 话 ， 你 应 该 只 使 
用 wx.PySimpleApp ， 且 不 需要 任何 其 它 的 全 局 参数 。 


理解 应 用 程序 对 象 的 生命 周期 


你 的 wxPython 应 用 程序 这 对 象 的 生命 周期 开始 于 应 用 程序 实例 被 创建 时 ， 在 最 后 一 
个 应 用 程序 窗口 被 关闭 时 结束 。 这 个 没有 必要 与 你 的 wxPython 应 用 程序 所 在 

的 Python 脚本 的 开始 和 结束 相对 应 。 Python 脚本 可 以 在 wxPython 应 用 程序 
创建 之 前 选择 做 一 动作 ， 并 可 以 在 wxPython 应 用 程序 的 MainLoop() 退出 后 做 
一 些 清理 工作 。 然 而 所 有 的 wxPython 动作 必须 在 应 用 程序 对 象 的 生命 周期 中 执 
行 。 正 如 我 们 曾 提 到 过 的 ， 这 意味 你 的 主 框架 对 象 在 wx.App 对 象 被 创 eee 
被 创建 。 (这 就 是 为 什么 我 们 建议 在 OnInit() 方法 中 创建 顶级 框架 
一 来 ， 就 确保 了 这 个 应 用 程序 已 经 存在 。) 


下 图 所 示 ， 创 建 应 用 程序 对 象 触发 OnInit() 方法 并 允许 新 的 窗口 对 象 被 创建 。 
在 OnInit() 之 后 ， 这 个 脚本 调用 MainLoop() 方法 ， 通 知 wxPython 事件 现在 
正在 被 处 理 。 在 窗口 被 关闭 之 前 应 用 程序 继续 它 的 事件 处 理 。 当 所 有 顶级 窗口 被 关 
闭 后 ， MainLoop() 元 数 返 回 同时 应 用 程序 对 象 被 注销 。 这 之 后 ， 这 个 脚本 能 够 
关闭 其 它 的 可 能 存 丰 的 连接 或 线程 。 


Automatically Events are now 
calls Ontnit() “| processed 
method] . " 
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Figure 2.2 Major events in the wxPython application lifecycle, including the beginning and ending of 
both the wxPython application and the script which surrounds it 


如 何 定向 WwxPython 程 序 的 输出 3 


所 有 的 Python 程序 都 能 够 通过 两 种 标准 流 来 输出 文本 : 分 别 是 标准 输出 
流 sys.stdout 和 标准 错误 流 sys.stderr 。 通 常 ， Python 脚本 定向 标准 输出 
流 到 它 所 运行 的 控制 台 。 然 而 ， 当 你 的 应 用 程序 对 象 被 创建 时 ， 你 可 以 决定 使 


用 wxPython 控制 标准 流 并 重 定向 输出 到 一 个 窗口 。 在 Windows 下 ， 这 个 重 定向 
行为 是 wxPython 的 默认 行为 。 而 在 Unix 系统 中 ， 默 认 情 况 下 ， wxPython 不 
控制 这 个 标准 流 。 在 所 有 的 系统 中 ， 当 应 用 程序 对 象 被 创建 的 时 候 ， 重 定向 行为 可 
以 被 明确 地 指定 。 我 们 推荐 利用 这 个 特性 并 总 是 指定 重 定向 行为 来 避免 不 同 平 台 上 
的 不 同行 为 产生 的 任何 问题 。 


重 定 向 输出 


如 果 wxPython 控制 了 标准 流 ， 那 么 经 由 任何 方法 发 送 到 流 的 文本 被 重 定向 到 一 
个 wxPython 的 框架 。 在 wxPyton 应 用 程序 开始 之 前 或 结束 之 后 发 送 到 流 的 文本 
将 按照 Python 通常 的 方法 处 理 (输出 到 控制 台 ) 。 下 例 同 时 演示 了 应 用 程序 的 生 
命 周 期 和 stdout / stderr 重 定向 : 


#!/usr/bin/env python 


import wx 
import sys 


class Frame(wx.Frame): 


def _ init_ (self, parent, id, title): 
print "Frame — init " 
wx.Frame. (init (self, parent, id, title) 


class App(wx.App): 


def _ init (self, redirect-True, filename=None): 
print "App init " 
wx.App. init (self, redirect, filename) 


def OnInit(self): 

print "OnInit" #4a d 2] stdout 

self.frame = Frame(parent=None, id=-1, title='Startup' ) 
# 创 建 框架 

self .frame.Show( ) 

self .SetTopwindow(self.frame) 

print sys.stderr, "A pretend error message" # 输 出 到 
stderr 

return True 


def OnExit(self): 
print "OnExit" 


if | name == ' main ': 
app = App(redirect=True) #1 文本 重 定向 从 这 开始 
print "before MainLoop" 
app.MainLoop() #2 进入 主事 件 循 环 
print "after MainLoop" 


说 明 : 

#1 这 行 创建 了 应 用 程序 对 象 。 这 行 之 后 ， 所 有 发 送 到 stderr 或 stdout 的 文本 
都 可 被 wxPython 重 定向 到 一 个 框架 。 参 数 redirect = True 决定 了 是 否 重 定 
向 。 


#2 运行 的 时 候 ， 应 用 程序 创建 了 一 个 空 的 框架 和 也 生成 了 一 个 用 于 重 定向 输出 的 框 
架 。 图 示 如 下 : 


| 
| 
| 





Figure 2.3 The stdout /stderr 
window created by Listing 2.1 


注意 : stdout 和 stderr 都 定向 到 这 个 窗口 。 当 你 运行 了 这 个 程序 之 后 ， 你 将 
会 看 到 你 的 控制 台 有 下 面 的 输出 : 


App __init__ after  MainLoop 


这 第 一 行 在 框架 被 打开 之 前 生成 ， 第 二 行 在 框架 被 关闭 之 后 生成 。 通过 观察 控制 台 
和 框架 的 输出 ， 我 们 可 以 跟踪 应 用 程序 的 生命 周期 。 


下 面 我 们 将 上 面 的 程序 与 图 2.2 作 个 比较 ， 图 中 的 " Start Script "对 应 于 程序 的 
. main 语句 。 然 后 立即 过 渡 到 下 一 “ Application  obect created ", 对 应 
于 程序 的 app = App(redirect = True) 。 应 用 程序 实例 的 创建 通过 调 

用 wx.App. init () 方法 。 然 后 是 OnInit() ， 它 被 wxPython 自动 调用 。 
从 这 里 ， 程 序 跳 转 到 wx.Frame. init () ， 它 是 在 wx.Frame 被 实例 化 时 运 
行 。 最 后 控制 转 回 到 main 3&5)» E> MainLoop() 被 调用 ， 对 应 于 图 中 
的 " MainLoop() called "。 主 循环 结 

后 ， wx.App.OnExit() 被 wxPython 调用 ， 对 应 于 图 中 “ Application 

object destroyed ”。 然 后 脚本 的 其 余部 分 完成 处 理 。 


为 什么 来 自 OnExit() 的 消息 既 没 显示 在 窗口 中 也 没 显 示 在 控制 台中 呢 ? 其 实 它 是 
在 窗口 关闭 之 前 显示 在 wxPython 的 框架 中 ， 但 窗口 消失 太 快 ， 所 以 无 法 被 屏幕 捕 
获 o 


修改 默认 的 重 定向 行为 


为 了 修改 这 个 行为 ， wxPython 允许 你 在 创建 应 用 程序 时 设置 两 个 参数 。 第 一 个 参 
数 是 redirect ， 如 果 值 为 True ， 则 重 定向 到 框架 ， 如 果 值 为 False ， 则 输出 
到 控制 台 。 如 果 参 数 redirect 为 True ， 那 么 第 二 个 参数 filename 也 能 够 被 
设置 ， 这 样 的 话 ， 输 出 被 重 定向 到 filename 所 指定 的 文件 中 而 不 定向 

到 wxPython 框架 。 因 此 ， 如 果 我 们 将 上 例 中 的 app = 

App(redirect = True) 改 为 app = App(False) ， 则 输出 将 全 部 到 控制 台 


App __init__ 

OnInit 

Frame _ init _ 

A pretend error message 
before MainLoop 

OnExit 

after MainLoop 


我 们 可 以 注意 到 onExit() 消息 在 这 里 显示 出 来 了 。 我 们 再 作 一 个 改变 : 


app = App(True, "output") 


这 将 导致 所 有 的 应 用 程序 创建 后 的 输出 重 定向 到 名 为 output 的 文件 中 。 
a" App init "fe" after MainLoop "消息 仍 将 发 送 到 控制 台 ， 这 是 因为 它们 
产生 在 wx. App 对 象 控 制 流 的 时 期 之 外 。 


如 何 关闭 WxPython 应 用 程序 ? 


当 你 的 应 用 程序 的 最 后 的 顶级 窗口 被 用 户 关 闭 时 ， M EROR 应 用 程序 就 退出 了 。 
我 们 这 里 所 说 的 顶层 窗口 是 指 任何 没有 父亲 的 框架 ， 并 不 只 是 使 
Al SetTopWindow() 方法 设计 的 框架 。 这 包括 任何 由 wxPython 自身 创 

o 在 我 们 重 定 向 的 例子 中 ， wxPython 应 用 程序 在 主 框架 和 输出 重 定向 的 框架 
被 关闭 后 退出 ， 仅 管 只 有 主 框架 是 使 用 SetTopwindow() 登记 的 ， id dg 
没有 明确 地 创建 这 个 输出 重 定向 框架 。 要 使 用 编程 触发 一 个 关闭 ， 你 可 以 在 所 有 的 
这 里 所 谓 顶 级 窗口 上 调用 Close() 方法 。 


管理 正常 的 关闭 


在 关闭 的 过 程 期 间 ， wxPython 关心 的 是 删除 所 有 的 它 的 窗口 和 释放 它们 的 资源 。 
你 可 以 在 退出 过 程 中 定义 一 个 钧 子 来 执行 你 自己 的 清理 工作 。 由 于 你 的 wx,App F 
类 的 onExit() 方法 在 最 后 一 个 窗口 被 关闭 后 且 在 wxPython 的 内 在 的 清理 过 程 

之 前 被 调用 ， 你 可 以 使 用 onExit() 方法 来 清理 你 创建 的 任何 非 wxPython 资源 

(例如 一 个 数据 库 连接 ) 。 即 使 使 用 了 wx.Exit() 来 关闭 wxPython 程 

序 ， OnExit() 方法 仍 将 被 触发 。 


如 果 由 于 某 种 原因 你 想 在 最 后 的 窗口 被 关闭 后 wxPython 应 用 程序 仍然 可 以 继续 ， 
你 可 以 使 用 wx.App 的 SetExitOnFrameDelete(flag) 方法 来 改变 默认 的 行为 。 
ho flag 参数 设置 为 False ， 那 么 最 后 的 窗口 被 关闭 后 wxPython 应 用 程序 仍 
然 会 继续 运行 。 这 意味 着 wx.App 实例 将 继续 存活 ， 并 且 事 件 循 环 将 继续 处 理事 
件 ， 比 如 这 时 你 还 可 以 创建 所 有 新 的 这 里 所 谓 的 顶级 窗口 。 wxPython 应 用 程序 将 
保持 存活 直到 全 局 函数 wx.Exit() 被 明确 地 调用 。 


管理 紧急 关闭 


你 不 能 总 是 以 一 个 可 控 的 方法 关闭 你 的 程序 。 有 时 候 ， 你 需要 立即 结束 应 用 程序 并 
不 考虑 清理 工作 。 例 如 一 个 必 不 可 少 的 资源 可 能 已 被 关闭 或 被 损坏 。 如 果 系 统 正在 
关闭 ， 你 可 能 不 能 做 所 有 的 清理 工作 。 


这 里 有 两 种 在 紧急 情况 下 退出 你 的 wxPython 应 用 程序 的 方法 。 你 可 以 调 

用 wx.App 的 ExitMainLoop() 方法 。 这 个 方法 显 式 地 使 用 主 消息 循环 终止 ， 使 
用 控制 离开 MainLoop() 函数。 这 通常 将 终止 应 用 程序 ， 这 个 方法 实际 上 等 同 于 
关闭 所 有 这 里 所 谓 顶 级 窗口 。 


你 也 可 以 调用 全 局 方法 wx.Exit() 。 正 常 使 用 情况 下 ， 两 种 方法 我 们 都 不 推荐 ， 


有 时 候 ， 你 的 应 用 程序 由 于 一 个 控制 之 外 的 事件 而 需要 关闭 。 例 如 操作 系统 的 关闭 
或 注销 。 在 这 种 情况 下 ， 你 的 应 用 程序 将 试图 做 一 些 保存 文档 或 关闭 连接 等 等 。 如 
果 你 的 应 用 程序 为 wx,.EVT_QUERY_END_SESSION 事件 绑 定 了 一 个 事件 处 理 器 ， 那 
么 当 wxPython 得 到 关闭 通知 时 这 个 事件 处 理 器 将 被 调用 。 这 个 event 参数 

X wx.CloseEvent 。 我 们 可 以 通过 关闭 事件 来 否决 关闭 。 这 可 以 使 用 关闭 事件 
的 CanVeto() 方法 ， Canveto() 方法 决定 是 否 可 以 否决 ， veto() 执行 否决 。 
如 果 你 不 能 成 功 地 保存 或 关闭 所 有 的 资源 ， 你 可 能 想 使 用 该 方 

ik ^ wx.EVT. QUERY END SESSION 事件 的 默认 处 理 器 调用 顶级 窗口 

的 Close() 方法 ， 这 将 依次 向 顶层 窗口 发 送 wx.EVT CLOSE 事件 ， 这 给 了 你 控制 
关闭 过 程 的 另 一 选择 。 如 果 任 何 一 个 Close() 方法 返回 False ， 那 么 应 用 程序 
将 试图 否决 关闭 。 


如 何 创 建 和 使 用 顶级 窗口 对 象 ? 


在 你 的 应 用 程序 中 一 个 顶级 窗口 对 象 是 一 个 窗口 部 件 (通常 是 一 个 框架 ) ， 它 不 被 
别 的 窗口 部 件 所 包含 。 顶 级 窗口 对 象 通常 是 你 的 应 用 程序 的 主 窗口 ， 它 包含 用 户 与 
之 交互 的 窗口 部 件 和 界面 对 象 。 当 所 有 的 顶级 窗口 被 关闭 时 应 用 程序 退出 。 


你 的 应 用 程序 至 少 必 须 有 一 个 顶级 窗口 对 象 。 顶 级 窗口 对 象 通常 是 类 wx.Frame 的 
子 类 ， 尽 管 它 也 可 以 是 wx.Dialog 的 子 类 。 大 多 数 情 况 下 ， 你 将 为 了 使 用 为 你 的 
应 用 程序 定义 定制 的 wx.Frame 的 子 类 。 然 而 ， 这 儿 也 存在 一 定数 量 的 预定 义 

的 wx.Dialog 的 子 类 ， 它 们 提供 了 许多 你 可 能 会 在 一 个 应 用 程序 中 遇 到 的 典型 的 
对 话 框 。 


这 儿 可 能 有 一 个 名 称 上 的 混淆 ， 那 就 是 “顶级 窗口 "。 一 般 意义 上 的 顶级 窗口 是 指 在 
你 的 应 用 程序 中 任何 没有 父 容 器 的 窗口 部 件 。 你 的 应 用 程序 必须 至 少 有 一 个 ， 但 
是 ， 只 要 你 喜欢 可 以 有 多 个 。 但 是 它们 中 只 有 一 个 可 以 通过 使 

用 SetTopWindow() 被 wxPython 作为 主 顶级 窗口 。 如 果 你 没有 使 

用 SetTopWindow() 指定 主 顶级 窗口 ， 那 么 在 wx.App 的 顶级 窗口 列表 中 的 第 一 
个 框架 将 被 认为 是 这 个 主 顶级 窗口 。 因 此 ， 明 确 地 定义 一 个 主 顶级 窗口 不 总 是 必要 
的 ， 例 如 ， 你 只 有 一 个 顶级 窗口 的 时 候 。 反 复 调 用 SetTopWindow() 将 反复 改变 
当前 的 主 顶 级 窗口 ， 因 为 一 个 应 用 程序 一 次 只 能 有 一 主 顶级 窗口 。 


使 用 wx.Frame 


按照 wxPython 中 的 说 法 ， 框 架 就 是 用 户 通常 称 的 窗 a piu ， 框架 是 一 个 容 
器 ， 用 户 可 以 将 它 在 屏幕 上 任意 移动 ， 并 可 将 , CRR 含 诸如 标题 栏 、 菜 


单 等 等 。 在 eno 中 ， wx.Frame 是 所 有 框架 的 父 类 。 数 专用 
的 wx.Frame 子 类 ， 你 可 以 使 用 它们 。 


当 你 创建 wx.Frame 的 子 类 时 ， 你 的 类 应 该 调用 其 父 类 的 构造 
器 wx.Frame. init () ° wx.Frame 的 构 造 器 所 要 求 的 参 数 如 下 


wx.Frame(parent, id=-1, title="", pos=wx.DefaultPosition, 
size=wx.DefaultSize, style=wx.DEFAULT_FRAME_STYLE, 
name-"frame") 


我 们 在 别 的 窗口 部 件 的 构造 器 中 将 会 看 到 类 似 的 参数 。 参 数 的 说 明 如 下 : 


parent 二 dein 。 对 于 顶级 窗口 ， 这 个 值 是 None 。 框 架 随 其 父 窗 口 的 
销 角 而 销毁 。 取 决 于 平台 ， 框 架 可 被 限制 只 出 现在 父 窗 口 的 顶部 。 在 多 文档 界面 的 
情 口 被 限制 为 只 能 在 父 窗口 中 移动 和 缩放 。 


id : 关于 新 窗口 的 wxPython ID 号 。 你 可 以 明确 地 传递 一 个 。 或 传递 -1， 这 
将 导致 wxPython 自动 生成 一 个 新 的 ID ° 


title : 窗口 的 标题 。 

pos :一 个 wx.Point 对 象 ， 它 指定 这 个 新 窗 口 的 左上 角 在 屏幕 中 的 位 置 。 在 图 
形 用 户 界面 程序 中 ， 通 常 (0,0) 是 显示 器 的 左上 角 。 这 个 默认 的 (-1,-1) 将 让 系统 决定 
窗口 的 位 置 。 


size :一 个 wx.Size 对 象 ， 它 指定 这 个 窗口 的 初始 尺寸 。 这 个 默认 的 (-1,-1) 将 
让 系统 决定 窗口 的 初始 尺寸 。 


style : 指定 窗口 的 类 型 的 常量 。 你 可 以 使 用 或 运算 来 组 合 它 们 。 
name :框架 的 内 在 的 名 字 。 以 后 你 可 以 使 用 它 来 寻找 这 个 窗口 。 
记 住 ， 这 些 参数 将 被 传递 给 父 类 的 构造 器 方法 : wx.Frame. init () ° 


创建 wx.Frame 子 类 的 方法 如 下 所 示 : 


class MyFrame(wx.Frame): 
def _ init (self): 
wx.Frame.__init__(self, None, -1, "My Friendly Window", 
(100, 100), (100, 100)) 


使 用 wxPython 的 ID 


在 wxPython 中 ， ID 号 是 所 有 窗口 部 件 的 特征 。 在 一 个 wxPython 应 用 程序 
中 ， 每 个 窗口 部 件 都 有 一 个 窗口 标识 。 在 每 一 个 框架 内 ， ID 号 必须 是 唯一 的 ， 但 
是 在 框架 之 间 你 可 以 重用 ID 号 。 然 而 ， 我 们 建议 你 在 你 的 整个 应 用 程序 中 保 


44 ID 号 的 唯一 性 ， 以 防止 处 理事 件 时 产生 错误 和 混淆 。 在 wxPython 中 也 有 一 
些 标准 的 预定 义 的 ID 号 ， 它 们 有 特定 的 意思 ( 例 

Je ^ wx.ID OK 和 wx.ID CANCEL 是 对 话 框 中 的 OK 和 Cancel 按钮 

的 ID >) 。 在 你 的 应 用 程序 中 重用 标准 的 ID 号 一 般 没 什么 问题 ， 只 要 你 在 预期 
的 方式 中 使 用 它们 。 在 wxPython P> ID 号 的 最 重要 的 用 处 是 在 指定 的 对 象 发 
生 的 事件 和 响应 该 事件 的 回调 函数 之 问 建立 唯一 的 关联 。 


有 三 种 方法 来 创建 一 个 窗口 部 件 使 用 的 ID 号 : 


1、 明 确 地 给 构造 器 传递 一 个 正 的 整数 2、 使 用 wx.NewId() 函数 3、 传递 一 个 全 
局 常量 wx.ID ANY 或 -1 给 窗口 部 件 的 构造 器 


明确 地 选择 ID 号 


第 一 个 或 最 直接 的 方法 是 明确 地 给 构造 器 传递 一 个 正 的 整数 作为 该 窗口 部 件 

的 ID 。 如 果 你 这 样 做 了 ， 你 必须 确保 在 一 个 框架 内 没有 重复 的 ID 或 重用 了 一 个 
预定 义 的 常量 。 你 可 以 通过 调用 wx.RegisterId() 来 确保 在 应 用 程序 

中 wxPython 不 在 别处 使 用 你 的 ID 。 要 防止 你 的 程序 使 用 相同 的 wxPython 

ID ， 你 应 该 避免 使 用 全 局 常量 wx.ID LOWEST 和 wx.ID HIGHEST 之 间 

的 ID 号 。 


使 用 全 局 性 的 NewID() X 


自己 确保 ID 号 的 唯一 性 十 分 麻烦 ， 你 可 以 使 用 wx.NewId() AA 
让 wxPython 来 为 你 创建 ID 


id = wx.NewId() 
frame = wx.Frame.__init__ (None, id) 


你 也 可 以 给 窗口 部 件 的 构造 器 传递 全 局 常量 wx. ID ANY 或 -1， 然 后 wxPython 将 
为 你 生成 新 的 ID 。 然 后 你 可 以 在 需要 这 个 ID 时 使 用 GetId() 方法 来 得 到 它 : 


frame = wx.Frame. init (None, -1) 
id - frame.GetId() 


使 用 wx.Size 和 wx.Point 


wx.Frame 构造 器 的 参数 也 引用 了 类 wx.Size 和 wx.Point 。 这 两 个 类 在 你 

的 wxPython 编程 中 将 频繁 被 使 用 。 wx.Point 类 表示 一 个 点 或 位 置 。 构 造 器 要 
求 点 的 x 和 y 值 。 如 果 不 设置 x,y 值 ， 则 值 默认 为 0。 我 们 可 以 使 

用 Set(x , y) 和 Get() 函数 来 设置 和 得 到 Xx 和 y 值 。 Get() 函数 返回 一 个 元 
组 。x 和 y 值 可 以 像 下 面 这 样 作 为 属性 被 访问 : 


point = wx.Point(10, 12) 
X = point.x 
y = point.y 


另外 ， wx.Point 的 实例 可 以 像 其 它 Python 对 象 一 样 作 加 、 减 和 比较 运算 ， 例 


wx.Point(2, 3) 
wx.Point(5, 7) 
=a+b 


在 wx.Point 的 实 参 中 ， 坐 标 值 一 般 为 整数 。 如 果 你 需要 浮 点 数 坐 标 ， 你 可 以 使 用 
类 wx.RealPoint ， 它 的 用 法 如 同 wx.Point ° 


wx.Size 类 几乎 和 wx.Point 完全 相同 ， 除 了 实 参 的 名 字 
是 width 和 height 。 对 wx.Size 的 操作 与 wx.Point 一 样 。 


在 你 的 应 用 程序 中 当 一 个 wx.Point 或 wx.Size 实例 被 要 求 的 时 候 〈 例 如 在 另 一 
个 对 象 的 构造 器 中 ) ， 你 不 必 显 式 地 创建 这 个 实例 。 你 可 以 传递 一 个 元 组 给 构造 
器 ， wxPython 将 隐 含 地 创建 这 个 wx.Point 或 wx.Size 实例 : 


frame = wx.Frame(None, -1, pos=(10, 10), size=(100, 100)) 


使 用 wx.Frame 的 样式 


每 个 wxPython 窗口 部 件 都 要 求 一 个 样式 参数 。 这 部 分 我 们 将 讨论 用 
于 wx.Frame 的 样式 。 它 们 中 的 一 些 也 适用 于 别 的 wxPython 窗口 部 件 。 一 些 窗 
口 部 件 也 定义 了 一 个 SetStyle() 方法 ， 让 你 可 以 在 该 窗口 部 件 创建 后 改变 它 的 
样式 。 所 有 的 你 能 使 用 的 样式 元 素 都 有 一 个 常量 标识 符 

(如 wx.MINIMIZE BOX ) 。 要 使 用 多 个 样式 ， 你 可 以 使 用 或 运算 符 |。 例 

如 ， wx.DEFAULT. FRAME STYLE 样式 就 被 定义 为 如 下 几 个 基本 样式 的 组 合 : 


wx.MAXIMIZE BOX | wx.MINIMIZE BOX | wx.RESIZE BORDER |wx.SYSTEM_ 
MENU | wx.CAPTION | wx.CLOSE_BOX 


要 从 一 个 合成 的 样式 中 去 掉 个 别 的 样式 ， 你 可 以 使 用 ^ 操 作 符 。 例 如 要 创建 一 个 默 
认 样 式 的 窗口 ， 但 要 求 用 户 不 能 缩放 和 改变 窗口 的 尺寸 ， 你 可 以 这 样 做 : 


wx.DEFAULT_FRAME_STYLE ^ (wx.RESIZE BORDER | wx.MINIMIZE BOX | wx 
.MAXIMIZE BOX) 


如 果 你 不 惯 使 用 了 & 操 作 符 ， 那 么 将 得 到 一 个 没有 样式 的 、 无 边框 图 的 、 不 能 移 
动 、 不 能 改变 尺寸 和 不 能 关闭 的 帧 。 


下 表 2.2 列 出 了 用 于 wx.Frame 的 最 重要 的 样式 : 


wX.CAPTION : 在 框架 上 增加 一 个 标题 栏 ， 它 显示 该 框架 的 标题 属性 。 
wx.CLOSE_BOX : 指示 系统 在 框架 的 标题 栏 上 显示 一 个 关闭 框 ， 使 用 系统 默认 的 
位 置 和 样式 。 wx.DEFAULT_FRAME_STYLE : 默认 样式 。  wx.FRAME SHAPED 

用 这 个 样式 创建 的 框架 可 以 使 用 setshape() 方法 去 创建 一 个 非 矩 形 的 窗口 。 
wx.FRAME_TOOL_WINDOW : 通过 给 框架 一 个 比 正常 更 小 的 标题 栏 ， 使 框架 看 起 来 
像 一 个 工具 框 窗口 。 在 windows 下 ， 使 用 这 个 样式 创建 的 框架 不 会 出 现在 显示 所 
有 打开 窗口 的 任务 栏 上 。 wx.MAXIMIZE_BOX : 指示 系统 在 框架 的 标题 栏 上 显示 一 
个 最 大 化 框 ， 使 用 系统 上 默认 的 位 置 和 样式 。 ^ wx.MINIMIZE BOX : 指示 系统 在 框架 
的 标题 栏 上 显示 一 个 最 小 化 框 ， 使 用 系统 默认 的 位 置 和 样式 。 

wX.RESIZE BORDER : 给 框架 增加 一 个 可 以 改变 尺寸 的 边框 。 

wx.SIMPLE_BORDER : 没有 装饰 的 边框 。 不 能 工作 在 所 有 平台 上 。 
wx.SYSTEM_MENU : 增加 系统 菜单 ( 带 有 关闭 、 移 动 、 改 变 尺 寸 等 功能 ) 和 关闭 
框 到 这 个 窗口 。 在 系统 菜单 中 的 改变 尺寸 和 关闭 功能 的 有 效 性 依赖 

于 wx.MAXIMIZE BOX , wx.MINIMIZE BOX 和 wx.CLOSE BOX 样式 是 否 被 应 用 。 


下 面 的 四 张 图 显示 了 几 个 通常 的 框架 的 样式 。 


Default lx 


Figure 2.4 A frame created with 
the default style 


—INo Resize Xi 


Figure 2.5 A frame created to 
be non-resizable. Notice the lack 
of minimize/maximize buttons. 


Frame Tool 





Figure 2.6 A toolbar frame, with a smaller title 
bar and no system menu 


Help Qik 


Figure 2.7 A frame 
with a help button 


图 2.4 是 使 用 wx.DEFAULT STYLE 创建 的 。 图 2.5 是 使 

用 wx.DEFAULT FRAME STYLE ^( wx.RESIZE BORDER | wx.MINIMIZE BOX 

| wx.MAXIMIZE BOX) 组 合 样式 创建 的 。 图 2.6 使 用 的 样式 

是 WX.DEFAULT_FRAME_STYLE | wx.FRAME_TOOL_WINDOW ° 图 2.7 使 用 了 扩展 样 
式 wx.help.FRAME EX CONTEXTHELP ° 


如 何 为 一 个 框架 增加 对 象 和 子 窗口 ? 


我 们 已 经 说 明了 如 何 创 建 wx.Frame 对 象 ， 但 是 创建 后 的 是 空 的 。 本 节 我 们 将 介绍 
在 你 的 框架 中 插入 对 象 与 子 窗口 的 基础 ， 以 便 与 用 户 交互 。 


给 框架 增加 窗口 部 件 


图 2. 8 显示 了 一 个 定制 的 wx.Frame 的 子 类 ， 名 为 InsertFrame ° 2A 
击 close 按钮 时 ， 这 个 窗口 将 关闭 且 应 用 程序 将 退出 。 例 2.3 定 义 了 子 
类 InsertFrame ° 


> 
| 


Figure 2.8 The InsertFrame 
window is an example demonstrating 
the basics of inserting items into 

a frame. 


PI 2.3 
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#!/usr/bin/env python 
import wx 
class InsertFrame(wx.Frame): 


def _ init (self, parent, id): 
wx.Frame.__init__(self, parent, id, 'Frame With Button', 
size-(300, 100)) 
panel = wx.Panel(self) # 创 建 画板 
button = wx.Button(panel, label="Close", pos=(125, 10), 
size-(50, 50)) # 将 按钮 添加 到 画板 
# 绑 定 按钮 的 单 击 事件 
self.Bind(wx.EVT BUTTON, self.OnCloseMe, button) 
HO BOM KASH 
self.Bind(wx.EVT CLOSE, self.OnCloseWindow) 


def OnCloseMe(self, event): 
self.Close(True) 


def OnCloseWindow(self, event): 
self.Destroy() 


if name == ' main ': 
app - wx.PySimpleApp() 
frame = InsertFrame(parent=None, id=-1) 
frame.Show( ) 
app .MainLoop( ) 


X InsertFrame 的 方法 _init_ 创建 了 两 子 窗口 。 第 一 个 是 wx.Panel > © 
是 其 它 窗 口 的 容器 ， 它 自身 也 有 一 点 功能 。 第 二 个 是 wx ,Button ， 它 是 一 个 平常 
按钮 。 接 下 来 ， 按 钮 的 单 击 事件 和 窗口 的 关闭 事件 被 绑 定 到 了 相应 的 函数 ， 当 事件 
发 生 时 这 相应 的 函数 将 被 调用 执行 。 


大 多 数 情 况 下 ， 你 将 创建 一 个 与 你 的 wx .Frame 大 小 一 样 的 wx .Panel 实例 以 容 
纳 你 的 框架 上 的 所 有 的 内 容 。 这 样 做 可 以 让 定制 的 窗口 内 容 与 其 他 如 工具 栏 和 状态 
栏 分 开 。 通过 tab 按钮 ， 可 以 遍历 wx.Panel 中 的 元 素 ， wx.Frame 不 能 。 


你 不 必 像 使 用 别 的 UI 工具 包 那 样 ， 你 不 需要 显 式 调用 一 个 增加 方法 来 向 双亲 中 插 
入 一 个 子 窗口 。 在 wxPython 中 ， 你 只 需 在 子 窗口 被 创建 时 指定 父 窗口 ， 这 个 子 窗 
口 就 隐 式 地 增加 到 父 对 和 象 中 了 ， 例 如 例 2.3 所 示 。 


你 可 能 想 知 道 在 例 2.3 中 ， 为 什么 wx.Button 被 创建 时 使 用 了 明确 的 位 置 和 尺寸 ， 
而 wx.Panel 没有 。 在 wxPython 中 ， 如 果 只 有 一 个 子 窗口 的 框架 被 创建 ， 那 么 
ARAS ( 例 2.3 中 是 wx.Panel ) 被 自动 重新 调整 尺寸 去 填 满 该 框架 的 客户 区 
域 。 这 个 自动 调整 尺寸 将 履 盖 关于 这 个 子 窗 口 的 任何 位 置 和 尺寸 信息 ， 尽 管 关于 子 
窗口 的 信息 已 被 指定 ， 这 些 信息 将 被 忽略 。 这 个 自动 调整 尺寸 仅 适 用 于 框架 内 或 对 


话 框 内 的 只 有 唯一 元 素 的 情况 。 这 里 按钮 是 panel 的 元 素 ， 而 不 是 框架 的 ， 所 以 
要 使 用 指定 的 尺寸 和 位 置 。 如 果 没 有 为 这 个 按钮 指定 尺寸 和 位 置 ， 它 将 使 用 默认 的 
ia ( panel HALA) 和 基于 按钮 标签 的 长 度 的 尺寸 。 


显 式 地 指定 所 有 子 窗口 的 位 置 和 尺寸 是 十 分 乏味 的 。 更 重要 的 是 ， 当 用 户 调整 窗口 
大 小 的 时 候 ， 这 使 得 子 窗口 的 位 置 和 大 小 不 能 作 相 应 调整 。 为 了 解决 这 两 个 问 
题 ，wxPython 使 用 了 称 为 sizers 的 对 象 来 管理 子 窗口 的 复杂 布局 。 


给 框架 增加 菜单 栏 、 工 具 栏 和 状态 栏 。 
图 2.9 显 示 了 一 个 有 菜单 栏 、 工 具 栏 和 状态 栏 的 框架 。 
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Figure 2.9 A sample frame with 
me nubar, toolbar, and status bar 


例 2.4 显 示 了 | init _ 方法 ， 它 用 这 三 个 子 窗口 装饰 了 一 个 简单 的 窗口 。 例 2.4 


#!/usr/bin/env python 


import wx 
import images 


class ToolbarFrame(wx.Frame): 
def _ init (self, parent, id): 
wx.Frame. init (self, parent, id, 
size-(300, 200)) 
panel - wx.Panel(self) 
panel.SetBackgroundColour( 'White') 


'Toolbars', 


statusBar = self.CreateStatusBar() #1 创建 状态 栏 
toolbar = self.CreateToolBar() #2 创建 工具 栏 


toolbar .AddSimpleTool(wx.NewId(), images.getNewBitmap(), 
"New", "Long help for 'New'") #3 给 工具 栏 增加 一 个 工 


R 
toolbar.Realize() #4 准备 显示 工具 栏 
menuBar = wx.MenuBar() # 创建 菜单 栏 
# 创建 两 个 菜 
menu1 = wx.Menu() 
menuBar.Append(menui, " ") 
menu2 = wx.Menu() 


46 创建 菜单 的 项 目 


menu2.Append(wx.NewId(), " ", 


menu2.Append(wx.NewId(), 
menu2.Append(wx.NewId(), 
menu2.AppendSeparator( ) 
menu2.Append(wx.NewId(), 


"Copy in status bar") 
Ue Lr n 
"Paste", LE 


n n 
, 


"Display Options") 


") # 在 菜单 栏 上 附 上 菜单 
# 在 框架 上 附 上 菜单 栏 


menuBar.Append(menu2, " 
self .SetMenuBar (menuBar ) 


if _name__ == ' main ': 
app = wx.PySimpleApp( ) 
frame = ToolbarFrame(parent=None, id=-1) 
frame.Show( ) 
app .MainLoop( ) 


说 明 : 


e #1: 这 行 创建 了 一 个 状态 栏 ， 它 是 类 wx.StatusBar 的 实例 。 它 被 放置 在 框 
架 的 底部 ， 宽 度 与 框架 相同 ， 高 度 由 操作 系统 决定 。 状 态 栏 的 目的 是 显示 在 应 
用 程序 中 被 各 种 事件 所 设置 的 文本 。 


#2 : 创建 了 一 个 wx .ToolBar 的 实例 ， 
在 框架 的 顶部 


#3: 有 两 种 方法 来 为 你 工具 栏 增 加 工具 ， 这 行使 用 了 参数 较 少 的 一 

ft: AddSimpleTool() 。 参 数 分 别 是 ID ， 位 图 ， 该 工具 的 短 的 帮助 提示 文 
本 ， 显 示 在 状态 栏 中 的 该 工具 的 长 的 帮助 文本 信息 。 (此 刻 不 要 考虑 位 图 从 哪 
JU) 


它 是 命令 按钮 的 容器 。 它 被 自动 放置 


#4: Realize() 方法 告诉 工具 栏 这 些 工具 按钮 应 该 被 放置 在 哪儿 。 这 是 必须 
的 。 


#6 : 创 LER e dk 数 分 别 代 表 ID ， 选 项 的 文本 ， 当 和 鼠标 位 于 其 上 


如 何 使 用 一 般 的 对 话 框 ? 


ee an 套 丰 富 的 预定 义 的 对 话 框 。 这 部 分 ， 我 们 将 讨论 三 种 用 对 话 框 
导 到 来 自用 户 的 信息 : 


1、 消 息 对 话 框 2、 文 本 输入 对 话 框 3、 从 一 个 列表 中 选择 
择 


在 wxPython 中 有 许多 别 的 标准 对 话 杠 | de CE 
框 、 打 印 设置 和 字体 选择 器 。 这 些 将 在 第 9 章 介 绍 。 


消息 对 话 框 


与 用 户 通 信和 最 基本 的 机 制 是 wx.MessageDialog ， 它 是 一 个 简单 的 提示 
框 。 wx.MessageDialog 可 用 作 一 个 简单 的 OK 框 或 yes / no 对 话 框 。 下 面 的 
片断 显示 了 yes / no 对 话 框 : 


dlg = wx.MessageDialog(None, 'Is this the coolest thing ever!', 
'MessageDialog', wx.YES NO | wx.ICON_QUEST 

ION) 

result - dlg.ShowModal() 

dlg.Destroy() 


示 结 果 如 图 2.10 所 示 : 


[MessageDialog | 


bag 





"4 pe Is this the coolest thing ever! 


TER | | 


Figure 2.10 A message 
dialog, configured for a 
vea/no resnanse 


wx.MessageDialog 参数 如 下 : 


wx.MessageDialog(parent, message, 
caption="Message box", 
style=wx.OK | wx.CANCEL, 
pos=wx.DefaultPosition) 


参数 说 明 : 


Ss 


parent : 对 话 框 的 父 窗口 ， 如 果 对 话 框 是 顶级 的 则 为 None © message : € 
示 在 对 话 框 中 的 字符 串 。 caption : 显示 在 对 话 框 标题 栏 上 的 字符 串 。 
style : 对 话 框 中 按钮 的 样式 。 pos : 对 话 框 出 现 的 位 置 。 


ShowModal() 方法 将 对 话 框 以 模式 框架 的 方式 显示 ， 这 意味 着 在 对 话 框 关闭 之 
前 ， 应 用 程序 中 的 别 的 窗口 不 能 响应 用 户 事 件 。 ShowModal() 方法 的 返回 值 是 一 


个 整数 ， 对 于 wx.MessageDialog ， 返 回 值 是 下 面 常量 之 一 : wx.ID YES , 
WwWX, ID NO , wx.ID CANCEL , wx.ID_OK ° 
文本 输入 对 话 框 


如 果 你 想 从 用 户 那 里 得 到 单独 一 行文 本 ， 你 可 能 使 用 类 wx.TextEntryDialog ° 
下 面 的 片断 创建 了 一 个 文本 输入 域 ， 当 用 户 单 击 OK 按钮 退出 时 ， 获 得 用 户 输入 的 
值 : 


dlg = wx.TextEntryDialog(None, "Who is buried in Grant's tomb?", 
"A Question', 'Cary Grant') 
if dlg.ShowModal() == wx.ID_OK: 
response = dlg.GetValue() 


图 2.11 显 示 了 上 面 这 个 对 话 框 : 





| Who is buried in Grant's tomb? | 





Figure 2.11 A text entry dialog 


LW wx.TextEntryDialog 的 参数 按 顺序 说 明 是 ， 父 窗口 ， 显 示 在 窗口 中 的 文 
本 标签 ， 窗 口 的 标题 (Rice Please enter text ") ， 输 入 域 中 的 默认 
值 。 同 样 它 也 有 一 个 样式 参数 ， 默 认 是 wx.0K | wx.CANCEL ° 

与 wx.MessageDialog 一 样 ， ShowModal() 方法 返回 所 按 下 的 按钮 

的 ID ° GetValue() 方法 得 到 用 户 输入 在 文本 域 中 的 值 (这 有 一 个 相应 

的 SetValue() 方法 让 你 可 以 改变 文本 域 中 的 值 ) 。 


从 一 个 列表 中 选择 


你 可 以 让 用 户 只 能 从 你 所 提供 的 列表 中 选择 ， 你 可 以 使 用 
类 wx.SingleChoiceDialog 。 下 面 是 一 个 简单 的 用 法 : 


dlg = wx.SingleChoiceDialog(None, 
'What version of Python are you using?', 
'Single Choice', 
| dom o epp qo qq aus OID oque 
if dlg.ShowModal() == wx.ID OK: 
response - dlg.GetStringSelection() 


图 2.12 显 示 了 上 面 代码 片断 的 结果 。 


Single Choice "m Xi 





What version of Python are you using? 











Figure 2.12 The 
SingleChoiceDialog 
window, allowing a user 
to choose from a 
predefined list 


wx.SingleChoiceDialog 的 参数 类 似 于 文本 输入 对 话 框 ， 只 是 以 字符 串 的 列表 代 
蔡 了 默认 的 字符 囊 文本 。 要 得 到 所 选择 的 纪 SRA RP EC GetSelection() Z7 
法 返回 用 户 选项 的 索引 ， 而 GetSstringselection() 返回 实际 所 选 的 字符 串 。 


一 些 最 常见 的 错误 现象 及 解决 方法 ? 


有 一 些 错误 它们 可 能 会 发 生 在 你 的 wxPython 应 meet Fe xt RR A 6 HY TH BE Al 
建 时 ， 这 些 错误 可 能 是 很 难 诊断 的 。 下 面 我 们 列 出 一 些 最 常见 的 错误 现象 及 解决 方 
法 : 

错误 现象 : 启动 时 提示 “ unable to import module wx °” 


原因 : wxPython 模块 不 在 你 的 PYTHONPATH 中 。 这 意味 着 wxPython 没有 被 正 
确 地 安装 。 如 果 你 的 系统 上 有 多 个 版 本 的 Python ， wxPython 可 能 安装 在 了 你 
没有 使 用 的 python 版 本 中 。 


解决 方法 : 首先 ， 确 定 你 的 系统 上 安装 了 哪些 版 本 的 Python 。 在 Unix 系统 
上 ， 使 用 which python 命令 将 告诉 你 默认 的 安装 。 在 Windows 系统 上 ， 如 
果 wxPython 被 安装 到 了 相应 的 Python 版 本 中 ， 它 将 位 于 python - home 
| Lib / site - packages 子 目 录 下 。 然 后 重 装 wxPython ° 


错误 现象 : 应 用 程序 启动 时 立即 前 溃 ， 或 前 溃 后 出 现 一 空白 窗口 
RA: 在 wx.App 创建 之 前 ， 创 建 或 使 用 了 一 个 wxPython 对 象 。 
解决 方法 : 在 启动 你 的 脚本 时 立即 创建 wx.App 对 象 。 

错误 现象 : 顶级 窗口 被 创建 同时 又 立刻 关闭 。 应 用 程序 立即 退出 。 
原因 : 没有 调用 wx.App 的 MainLoop() 方法 。 

解决 方法 : 在 你 的 所 有 设置 完成 后 调用 MainLoop() 方法 。 


错误 现象 : 顶级 窗口 被 创建 同时 又 立刻 关闭 。 应 用 程序 立即 退出 。 但 我 调用 
了 MainLoop() 方法 。 


原因 : 你 的 应 用 程序 的 OnInit() 方法 中 有 错误 ， 或 OnInit() 方法 调用 了 某 些 
方法 (de M B init () 方法 ) 。 


解决 方法 : 在 MainLoop() 被 调用 之 前 出 现 错误 的 话 ， 这 将 触发 一 个 异常 且 程 序 
退出 。 A Md ts 口 将 一 闪 而 过 ， 你 
不 能 看 到 显示 在 窗口 中 的 错误 信息 。 这 种 情况 下 ， 你 要 使 用 
redirect = False 关闭 。 先 项 ， 以 便 看 到 错误 提示 。 


CK 


1. wxPython 程序 的 实现 基于 两 个 必要 的 对 象 : 应 用 程序 对 象 和 顶级 窗口 。 任 
何 wxPython 应 用 程序 都 需要 去 实例 化 一 个 wx.App ， 并 且 至 少 有 一 个 顶级 
窗口 。 


2. 应 用 程序 对 象 包含 0nInit() 方法 ， 它 在 启动 时 被 调用 。 在 这 个 方法 中 ， 通 常 
要 初始 化 框架 和 别 的 全 局 对 象 。 wxPython 应 用 程序 通常 在 它 的 所 有 的 顶级 窗 
口 被 关闭 或 主事 件 循环 退出 时 结束 。 


3. 应 用 程序 对 象 也 控制 wxPython 文本 输出 的 位 置 。 上 默认 情况 
下 ， wxPython 重 定向 stdout 和 stderr 到 — Mt eA 窗口 。 这 个 行为 使 
得 诊断 启动 时 产 Lp 困难 了 。 但 是 我 们 可 以 通过 让 wxPython 把 错误 
消息 发 送 到 一 个 文件 或 控制 台 窗 口 来 解决 。 


4. 一 个 wxPython 应 用 程序 通常 至 少 有 一 个 wx.Frame 的 子 类 。 一 
个 wx.Frame 对 象 可 以 使 用 style 参数 来 创建 组 合 的 样式 。 每 
wxWidget 对 象 ， 包 括 框架 ， 都 有 一 个 ID ， 这 个 ID 可 以 被 应 用 程序 显 
式 地 赋值 或 由 wxPython 生成 。 子 窗口 是 框架 的 内 容 ， 框 架 是 它 的 双亲 。 通 
常 ， 一 个 框架 包含 一 个 单一 的 wx.Panel ， 更 多 的 子 窗口 被 放置 在 这 
个 Panel 中 。 框 架 的 唯一 的 子 窗口 的 尺寸 自动 随 其 父 框架 的 尺寸 的 改变 而 改 
医 架 有 明确 的 关于 管理 菜单 栏 、 工 具 栏 和 状态 栏 的 机 制 。 


5. 尽管 你 将 使 用 框架 做 任何 复杂 的 事情 ， 但 当 你 想 简单 而 快速 地 得 到 来 自用 户 的 
信息 时 ， 你 可 以 给 用 户 显示 一 个 标准 的 对 话 窗口 。 对 于 很 多 任务 都 有 标准 的 对 
话 框 ， 包 括 警 告 框 、 简 单 的 文本 输入 框 和 列表 选择 框 等 等 。 


第 三 章 在 事件 驱动 环境 中 开发 


1. 在 事件 驱动 环境 中 工作 
ij， 要 理解 事件 ， 我 们 需要 知道 哪些 术语 ? 
ii， 什么 是 事件 驱动 编程 ? 
i， 编 写 事件 处 理 器 
i 设计 事件 驱动 程序 
ii. ARR 
iii, 0 Fo 1 SAAB eB] Ab 3E 257 
i 使 用 wx.EvtHandler 的 方法 工作 
iv. wxPython 是 如 何 处 理事 件 的 ? 
i 理解 事件 处 理 过 程 
i 使 用 Skip() 方 法 
v. 在 应 用 程序 对 象 中 还 包含 哪些 其 它 的 属性 ? 
vi， 如 何 创 建 自己 的 事件 ? 
ij， 为 一 个 定制 的 窗口 部 件 定义 一 个 定制 的 事件 
vii. 3&2 
事件 处 理 是 wxPython 程序 工作 的 基本 机 制 。 主 要 执行 事件 处 理 的 工作 称 为 事件 驱 
动 。 在 这 章 中 我 们 将 讨论 什么 是 事件 驱动 应 用 程序 ， 它 与 传统 的 应 用 程序 有 什么 不 
同 。 我 们 将 对 在 GUI 编程 中 所 使 用 的 概念 和 术语 提供 一 些 介绍 ， 包 括 与 用 户 交 
互 ， 工 具 包 和 编程 逻辑 。 也 将 包括 典型 事件 驱动 程序 的 生命 周期 。 


事件 就 是 发 生 在 你 的 系统 中 的 事 ， 你 的 应 用 程序 通过 触发 相应 的 功能 以 响应 它 。 事 
件 可 以 是 低级 的 用 户 动作 ， 如 鼠标 移动 或 按键 按 下 ， 也 可 以 是 高 级 的 用 户 动作 ( 定 
SUE wxPython 的 窗口 部 件 中 的 ) ， 如 单 击 按钮 或 菜单 选择 。 事 件 可 以 产生 自 系 
统 ， 如 关机 。 你 甚至 可 以 创建 你 自己 的 对 象 去 产生 你 自己 的 事件 。 wxpython 应 用 
程序 通过 将 特定 类 型 的 事件 和 特定 的 一 块 代码 相关 联 来 工作 ， 该 代码 在 响应 事件 时 
执行 。 事 件 被 映射 到 代码 的 过 程 称 为 事件 处 理 。 


本 章 将 说 明 事 件 是 什么 ， 你 如 何 写 响应 一 个 事件 的 代码 ， 以 及 wxPython 在 事件 发 
生 的 时 候 是 如 何 知 道 去 调用 你 的 代码 的 。 我 们 也 将 说 明 如 何 将 定制 的 事件 增加 
到 wxPython 库 中 ， 该 库 包含 了 关于 用 户 和 系统 行为 的 标准 事件 的 一 个 列表 。 


As 


要 理解 事件 ， 我 们 需要 知道 哪些 术语 ? 

本 章 包 含 了 大 量 的 术语 ， 很 多 都 是 以 event 开头 的 。 下 表 3.1 是 我 们 将 要 用 到 的 术 
语 的 一 个 快速 参考 : 

事件 ( event) : 在 你 的 应 用 程序 期 间 发 生 的 事情 ， 它 要 求 有 一 个 响应 。 


事件 对 象 ( event object) :在 wxPython 中 ， 它 具体 代表 一 个 事件 ， 其 中 包 
括 了 事件 的 数据 等 属性 。 它 是 类 wx.Event 或 其 子 类 的 实例 ， 子 类 


如 wx.CommandEvent 和 wx.MouseEvent ° 


事件 类 型 ( event type) : wxPython 分 配给 每 个 事件 对 象 的 一 个 整数 ID © 
事件 类 型 给 出 了 关于 该 事件 本 身 更 多 的 信息 。 例 如 ， wx.MouseEvent 的 事件 类 型 
标识 了 该 事件 是 一 个 鼠标 单 击 还 是 一 个 鼠标 移动 。 


事件 源 ( event source) :任何 wxPython 对 象 都 能 产生 事件 。 例 如 按钮 、 菜 
单 、 列 表 框 和 任何 别 的 窗口 部 件 。 


事件 驱动 ( event - driven) : 一 个 程序 结构 ， 它 的 大 部 分 时 间 花 在 等 待 或 响应 事 
件 上 。 


事件 队列 ( event queue) : 已 发 生 的 但 未 处 理 的 事件 的 一 个 列表 。 


事件 处 理 器 ( event handler) : 响应 事件 时 所 调用 的 函数 或 方法 。 也 称 作 处 理 
器 函数 或 处 理 器 方法 。 


事件 绑 定 器 ( event binder) :一 个 封装 了 特定 窗口 部 件 ， 特 定 事件 类 型 和 一 个 
事件 处 理 器 的 wxPython 对 象 。 为 了 被 调用 ， 所 有 事件 处 理 器 必须 用 一 个 事件 绑 定 
器 注册 。 

wx.EvtHandler : 一 个 wxPython 类 ， 它 允许 它 的 实例 在 一 个 特定 类 型 ， 一 个 事 


件 源 ， 和 一 个 事件 处 理 器 之 问 创建 缚 定 。 注 意 ， 这 个 类 与 先前 定义 的 事件 处 理 函 数 
或 方法 不 是 同一 个 东西 。 


什么 是 事件 驱动 编程 ? 


事件 驱动 程序 主要 是 一 个 控制 结构 ， 它 接受 事件 并 响应 它们 。 wxPython 程序 (或 
任何 事件 驱动 程序 ) 的 结构 与 平常 的 Python 脚本 不 同 。 标 准 的 Python 脚本 有 
一 个 特定 的 开始 点 和 结束 点 ， 程 序 员 使 用 条 件 、 循 环 、 和 函数 来 控制 执行 顺序 。 


从 用 户 的 角度 上 来 看 ， wxPython 程序 大 部 分 时 间 什 么 也 不 做 ， 一 直 闲 着 直到 用 户 
或 系统 做 了 些 什么 来 触发 这 个 wxPython 程序 动作 。 wxPython 程序 的 结构 就 是 
一 个 事件 驱动 程序 体系 的 例子 。 图 3.1 是 事件 处 理 循环 的 示意 ， 它 展示 了 主 程 序 的 生 
命 、 用 户 事件 、 和 分 派 到 的 处 理 器 函数 。 
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Figure 3.1 Aschematic of the event handling cycle, showing the life of the main 
program, a user event, and dispatch to handler functions. 






事件 驱动 系统 的 主 循环 类 似 于 客户 服务 呼叫 中 心 的 操作 者 。 当 没有 呼叫 的 进入 的 时 
候 ， 这 个 操作 者 处 于 等 待 状态 。 当 一 个 事件 发 生 的 时 候 ， 如 电话 铃 响 了 ， 这 个 操作 
者 开始 一 个 响应 过 程 ， 他 与 客户 交谈 直到 他 获得 足够 的 信息 以 分 派 该 客户 给 一 个 合 
适 的 回答 者 。 然 后 操作 者 等 待 下 一 个 事件 。 


尽管 每 个 事件 驱动 系统 之 间 有 一 些 不 同 ， 但 它们 有 很 多 相似 的 地 方 。 下 面 列 出 了 事 
件 驱动 程序 结构 的 主要 特点 : 


1、 在 初始 化 设置 之 后 ， 程 序 的 大 部 分 时 间 花 在 了 一 个 空 闭 的 循环 之 中 。 进 入 这 个 
稍 环 就 标志 闫 程序 与 用 户 交互 的 部 分 的 开始 ， 退 出 这 个 循环 就 标志 结束 。 

在 wxPython 中 ， 这 个 循环 的 方法 是 : wx.App.MainLoop() ， 并 且 在 你 的 脚本 
中 显 式 地 被 调用 。 当 所 有 的 顶级 窗口 关闭 时 ， 主 循环 退出 。 


2、 程 序 包 含 了 对 应 于 发 生 在 程序 环境 中 的 事情 的 事件 。 事 件 通常 由 用 户 的 行为 蚀 
发 ， 但 是 也 可 以 由 系统 的 行为 或 程序 中 其 他 任意 的 代码 。 在 wxPython 中 ， 所 有 的 
事件 都 是 类 wx.Event 或 其 子 类 的 一 个 实例 。 每 个 事件 都 有 一 个 事件 类 型 属性 ， 它 
使 得 不 同 的 事件 能 够 被 辨别 。 例 如 ， 和 鼠标 释放 和 和 鼠 示 按 下 事件 都 被 认为 是 同一 个 类 
的 实例 ， 但 有 不 同 的 事件 类 型 。 


3、 作 为 这 个 空 闭 的 循环 部 分 ， 程 序 定 期 检查 是 否 有 任何 请 求 响应 事情 发 生 。 有 两 
种 机 制 使 得 事件 驱动 系统 可 以 得 到 有 关 事 件 的 通知 。 最 常 被 wxPython 使 用 的 方法 
是 ， 把 事件 传送 到 一 个 中 心 队 列 ， 由 该 队列 触发 相应 事件 的 处 理 。 另 一 种 方法 是 使 
用 轮 询 的 方法 ， 所 有 可 能 引发 事件 的 事件 主 被 主 过 程 定 期 查询 并 询问 是 否 有 没有 处 
理 的 事件 。 


4、 当 事件 发 生 时 ， 基 于 事件 的 系统 试 着 确定 相关 代码 来 处 理 该 事件 ， 如 果 有 ， 相 
关 代 码 被 执行 。 在 wxPython 中 ， 原 系统 事件 被 转换 为 wx.Event 实例 ， 然 后 使 
用 wx. EvtHandler .ProcessEvent ( ) 方法 将 事件 分 派 给 适当 的 处 理 器 代码 。 图 3.3 
呈现 了 这 个 过 程 : 
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Figure 3.3 Event handling process, starting with the event being triggered, and moving through the 
steps of searching for a handler 


事件 机 制 的 组 成 部 分 是 事件 绑 定 器 对 象 和 事件 处 理 器 。 事 件 绑 定 器 是 一 个 预定 义 

的 wxPython 对 象 。 每 个 事件 都 有 各 自 的 事件 绑 定 器 。 事件 处 理 器 是 一 个 函数 或 方 
法 ， 它 要 求 一 个 wxPython 事件 实例 作为 参数 。 当 用 户 触发 了 适当 的 事件 时 ， 一 个 
事件 处 理 器 被 调用 。 


wxPython 更 多 的 细节 ， 我 们 把 事件 响应 的 基本 单元 "事件 处 
器 "作为 开始 。 


编写 事件 处 理 器 


在 你 的 wxPython 代码 中 ， 事 件 和 事件 处 理 器 是 基于 相关 的 窗口 部 件 的 。 例 如 ， 一 
个 按钮 被 单 击 被 分 派 给 一 个 基于 该 按钮 的 专用 的 事件 处 理 器 。 为 了 要 把 一 个 来 自 特 
定 窗 口 部 件 的 事件 绑 定 到 一 个 特定 的 处 理 器 方法 ， 你 要 使 用 一 个 绑 定 器 对 象 来 管理 
这 个 连接 。 例 如 : 


self.Bind(wx.EVT BUTTON, self.OnClick, aButton) 


上 例 使 用 了 预定 义 的 事件 绑 定 器 对 象 wx.EVT. BUTTON 来 将 aButton 对 象 上 的 按 
钮 单 击 事件 与 方法 self.OnClick 相关 联 起 来 。 这 个 Bind() 方法 

是 wx.EvtHandler 的 一 个 方法 ， wx.EvtHandler 是 所 有 可 显示 对 象 的 父 类 。 
此 上 例 代 码 行 可 以 被 放置 在 任何 显示 类 。 


即使 你 的 wxPython 程序 表面 上 看 起 来 在 被 动 地 等 待 事件 ， 但 它 仍 在 做 事 。 它 在 运 
行 方法 wx.App.MainLoop() ， 该 方法 是 一 个 无 限 的 循环 。 MainLoop() 方法 可 
以 使 用 Python 伪 代 码 表示 如 下 : 


while True: 

while not self.Pending(): 
self .ProcessIdle() 
self .DoMessage() 


上 面 的 伪 代 码 意 思 是 如 果 没 有 未 处 理 的 消息 ， 则 做 一 些 空闲 时 做 的 事 ; 如 果 有 消息 
消息 分 派 给 


SE 
进入 ， 那 么 将 这 个 消息 适当 的 事件 处 理 方法 。 


设计 事件 驱动 程序 


对 于 事件 驱动 程序 的 设计 ， 由 于 没有 假设 事件 何 时 发 生 ， 所 以 程序 员 将 大 量 的 控制 
交 给 了 用 户 。 你 的 wxPython 程序 中 的 大 多 数 代 码 通 过 用 户 或 系统 的 行为 被 直接 或 
间接 地 执行 。 例 如 在 用 户 选择 了 一 个 菜单 项 、 或 按 下 一 个 工具 栏 按钮 、 或 按 下 了 特 
定 的 按键 组 合 后 ， 你 的 程序 中 有 关 保 存 工作 的 代码 被 执行 了 。 


另 一 方面 ， 事 件 驱动 体系 通常 是 分 散 性 的 。 响 应 一 个 窗口 部 件 事件 的 代码 通常 不 是 
定义 在 该 部 件 的 定义 中 的 。 例 如 ， 响 应 一 个 按钮 单 击 事件 的 代码 不 必 是 该 按钮 定义 
的 一 部 分 ， 而 可 以 存在 在 该 按钮 所 附 的 框架 中 或 其 它 地 方 。 当 与 面向 对 象 设计 结合 
时 ， 这 个 体系 导致 了 松散 和 高 度 可 重用 的 代码 。 你 将 会 发 现 python 的 灵活 使 得 重 
用 不 同 的 wxPython 应 用 程序 的 通常 的 事件 处 理 器 和 结构 变 得 非常 容易 。 


事件 触发 


在 wxPython 中 ， 大 部 分 窗口 部 件 在 响应 低级 事件 时 都 导致 高 级 事件 发 生 。 例 如 ， 
在 一 个 wx.Button 上 的 鼠标 单 击 导 致 一 个 EVT_BUTTON 事件 的 生成 ， 该 事件 

是 wx.CommandEvent 的 特定 类 型 。 类 似 的 ， 在 一 个 窗口 的 角 中 拖 动 鼠标 将 导 

致 wxPython 为 你 自动 创建 一 个 wx.SizeEvent 事件 。 高 级 事件 的 用 处 是 让 你 的 
系统 的 其 它 部 分 更 容易 聚焦 于 最 有 关联 的 事件 上 ， 而 不 是 陷于 追踪 每 个 鼠标 单 击 。 
高 级 事件 能 够 封装 更 多 关于 事件 的 有 用 的 信息 。 当 你 创建 你 自己 的 定制 的 窗口 部 件 
时 ， 你 能 定义 你 自己 的 定制 事件 以 便 管 理事 件 的 处 理 。 


在 wxPython 中 ， 代 表 事件 的 是 事件 对 象 。 事 件 对 象 是 类 wx.Event 或 其 子 类 的 
一 个 实例 。 父 类 wx.Event 相对 小 且 抽 象 ， 它 只 是 包含 了 对 所 有 事件 的 一 些 通常 的 
信息 。 wx.Event 的 各 个 子 类 都 添加 了 更 多 的 信息 。 


在 wxPython 中 ， 有 一 些 wx.Event 的 子 类 。 表 3.2 包 含 了 你 将 最 常 遇 到 的 一 些 事 
件 类 。 记 住 ， 一 个 事件 类 可 以 有 多 个 事件 类 型 ， 每 个 都 对 应 于 一 个 不 同 的 用 户 行 
为 。 下 表 3.2 是 wx.Event 的 重要 的 子 类 。 


wx.CloseEvent : 当 一 个 框架 关闭 时 触发 。 这 个 事件 的 类 型 分 为 一 个 通常 的 框架 
关闭 和 一 个 系统 关闭 事件 。 wx.CommandEvent :与 窗口 部 件 的 简单 的 各 种 交互 都 
将 触发 这 个 事件 ， 如 按钮 单 击 、 菜 单项 选择 、 单 选 按钮 选择 。 这 些 交互 有 它 各 自 的 


事件 类 型 。 许 多 更 复杂 的 窗口 部 件 ， 如 列表 等 则 定义 wx.commandEvent 的 子 类 。 
事件 处 理 系 统 对 待命 令 事件 与 其 它 事 件 不 同 。 wx.KeyEvent : 按 按键 事件 。 这 个 
事件 的 类 型 分 按 下 按键 、 释 放 按 键 、 整 个 按键 动作 。 wx.MouseEvent : 鼠标 事 
件 。 这 个 事件 的 类 型 分 鼠标 移动 和 鼠标 殴 击 。 对 于 哪个 鼠标 按钮 被 融 击 和 是 单 击 还 
是 双击 都 有 各 自 的 事件 类 型 。 wx.PaintEvent : 当 窗 口 的 内 容 需 要 被 重 画 时 触 
发 。 wx.SizeEvent : 当 窗 口 的 大 小 或 其 布局 改变 时 触发 。 wx.TimerEvent 
可 以 由 类 wx.Timer 类 创建 ， 它 是 定期 的 事件 。 


通常 ， 事 件 对 象 需 要 使 用 事件 绑 定 器 和 事件 处 理 系 统 将 它们 传递 给 相关 的 事件 处 理 
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如 何 将 事件 绑 定 到 处 理 器 ? 


事件 绑 定 器 由 类 wx.PyEventBinder 的 实例 组 成 。 一 个 预定 义 

的 wx.PyEventBinder 的 实例 被 提供 给 所 有 支持 的 事件 类 型 ， 并 且 在 你 需要 的 时 
候 你 可 以 为 你 定制 的 事件 创建 你 自己 的 事件 绑 定 器 。 每 个 事件 类 型 都 有 一 个 事件 绑 
定 器 ， 这 意味 着 一 个 wx.Event 的 子 类 对 应 多 个 绑 定 器 。 


在 wxPython 中 ， 事 件 绑 定 器 实例 的 名 字 是 全 局 性 的 。 为 了 清楚 地 将 事件 类 型 与 处 
理 器 联系 起 来 ， 它 们 的 名 字 都 是 以 wx.EVT_ 开头 并 且 对 应 于 使 用 在 C++ 
wxWidgets 代码 中 宏 的 名 字 。 值 得 强调 的 是 ， wx.EVT 绑 定 器 名 字 的 值 不 是 你 通 
过 调用 一 个 wx.Event 实例 的 GetEventType() 方法 得 到 的 事件 类 型 的 实际 的 整 
数码 。 事 件 类 型 整数 码 有 一 套 完全 不 同 的 全 局 名 ， 并 且 在 实际 中 不 常 被 使 用 。 


作为 wx.EVT 名 字 的 例子 ， 让 我 们 看 看 wx.MouseEvent 的 事件 类 型 。 正 如 我 们 所 
提 到 的 ， 它 们 有 十 四 个 ， 其 中 的 九 个 涉及 到 了 基于 在 按钮 上 的 敲 击 ， 如 鼠标 按 下 、 
鼠标 释放 、 或 双击 事件 。 这 九 个 事件 类 型 使 用 了 下 面 的 名 字 : 


WX.EVT LEFT DOWN 
wXx.EVT LEFT UP 
wXx.EVT LEFT DCLICK 
wWX.EVT MIDDLE DOWN 
wX.EVT MIDDLE UP 
wx.EVT MIDDLE DCLICK 
WX.EVT RIGHT DOWN 
WX.EVT RIGHT UP 
wX.EVT RIGHT DCLICK 


另外 ， 类 型 wx.EVT. MOTION 产生 于 用 户 移动 鼠标 。 类 

型 wx.ENTER WINDOW 和 wx.LEAVE WINDOW 产生 于 当 鼠 标 进入 或 离开 一 个 窗口 部 
件 时 。 类 型 wx.EVT_MOUSEWHEEL 被 缚 定 到 鼠标 滚轮 的 活动 。 最 后 ， 你 可 以 使 用 类 
型 wx.EVT MOUSE EVENTS 一 次 绑 定 所 有 的 鼠标 事件 到 一 个 函数 。 


同样 ， 类 wx.CommandEvent 有 28 个 不 同 的 事件 类 型 与 之 关联 ; 尽管 有 几 个 仅 针 对 
老 的 Windows 操作 系统 。 它 们 中 的 大 多 数 是 专门 针对 单一 窗口 部 件 的 ， 

如 wx.EVT BUTTON 用 于 按钮 敲 击 ， wx.EVT_MENU 用 于 菜单 项 选择 。 用 于 专门 窗 
口 部 件 的 命令 事件 在 part2 中 讨论 。 


绑 定 机 制 的 好 处 是 它 使 得 wxPython 可 以 很 细 化 地 分 派 事件 ， 而 仍然 允许 同类 的 类 
似 事件 发 生 并 且 共 享 数据 和 功能 。 这 使 得 在 wxPython 中 写 事 件 处 理 比 在 其 它 界 面 
工具 包 中 清 细 得 多 。 


事件 绑 定 器 被 用 于 将 一 个 wxPython 窗口 部 件 与 一 个 事件 对 象 和 一 个 处 理 器 函数 连 
接 起 来 。 这 个 连接 使 得 wxPython 系统 能 够 通过 执行 处 理 器 函数 中 的 代码 来 响应 相 
应 窗口 部 件 上 的 事件 。 在 wxPython 中 ， 任 何 能 够 响应 事件 的 对 象 都 

是 wx.EvtHandler 的 子 类 。 所 有 窗口 对 象 都 是 wx.EvtHandler 的 子 类 ， 因 些 
在 wxPython 应 用 程序 中 的 每 个 窗口 部 件 都 能 够 响应 事件 。 类 wx.EvtHandler 也 
能 够 被 非 窗 口 部 件 对 象 所 使 用 ， 如 wx. App ， 因 此 事件 处 理 功能 不 是 限于 可 显示 的 
窗口 部 件 。 我 们 所 说 的 窗口 部 件 能 响应 事件 的 意思 是 : 该 窗口 部 件 能 够 创建 事件 绑 
定 ， 在 分 派 期 间 wxPython 能 够 识别 该 事件 绑 定 。 由 绑 定 器 调用 的 在 事件 处 理 器 函 
数 中 的 实际 代码 不 是 必须 位 于 一 个 wx.EvtHandler 类 中 。 


使 用 wx.EvtHandler 的 方法 工作 


wx.EvtHandler 类 定义 的 一 些 方 法 在 一 般 情 况 下 用 不 到 。 你 会 经 常 使 用 
的 wx.EvtHandler 的 方法 是 Bind() ， 它 创建 事件 绑 定 。 该 方法 的 用 法 如 下 : 


Bind(event, handler, source=None, id=wx.ID_ANY, id2=wx.ID_ANY) 


Bind() 函数 将 一 个 事件 和 一 个 对 象 与 一 个 事件 处 理 器 函数 关联 起 来 。 参 

数 event 是 必 选 的 ， 它 是 我 们 在 3.3 节 中 所 说 的 wx.PyEventBinder 的 一 个 实 

例 。 参 数 handler 也 是 必 选 的 ， 它 是 一 个 可 调用 的 Python 对 象 ， 通 常 是 一 个 被 
绑 定 的 方法 或 了 叉 数 。 处 理 器 必须 是 可 使 用 一 个 参数 (事件 对 象 本 身 ) 来 调用 的 。 参 
数 handler 可 以 是 None ， 这 种 情况 下 ， 事 件 没 有 关联 的 处 理 器 。 参 

数 source 是 产生 该 事件 的 源 窗口 部 件 ， 这 个 参数 在 触发 事件 的 窗口 部 件 与 用 作 事 
件 处 理 器 的 窗口 部 件 不 相同 时 使 用 。 通 常情 况 下 这 个 参数 使 用 默认 值 None ， 这 是 
因为 你 一 般 使 用 一 个 定制 的 wx.Frame 类 作为 处 理 器 ， 并 且 绑 定 来 自 于 包含 在 该 杠 
架 内 的 窗口 部 件 的 事件 。 父 窗口 的 ” init 是 一 个 用 于 声明 事件 绑 定 的 方便 的 位 
置 。 但 是 如 果 父 窗口 包含 了 多 个 按钮 敲 击 事件 源 (比如 ok 按钮 和 Cancel 按 

42) ， 那 么 就 要 指定 source 参数 以 便 wxPython 区 分 它们 。 下 面 是 该 方法 的 一 
个 例子 : 


self.Bind(wx.EVT BUTTON, self.OnClick, button) 


下 例 3.1 演 示 了 使 用 参数 source 和 不 使 用 参数 source 的 方法 ， 它 改编 自 第 二 章 
中 的 代码 : 


def _init__(self, parent, id): 
wx.Frame.__init__(self, parent, id, 'Frame With Button', 
size=(300, 100) ) 
panel = wx.Panel(self, -1) 
button = wx.Button(panel, -1, "Close", pos=(130, 15), 
size=(40, 40)) 
self.Bind(wx.EVT CLOSE, self.OnCloseWindow) £1 绑 定 框架 关闭 事件 
self.Bind(wx.EVT BUTTON, self.OnCloseMe, button) #2 绑 定 按钮 事 
件 


def OnCloseMe(self, event): 
self .Close(True) 

def OnCloseWindow(self, event): 
self .Destroy() 


说 明 : 
#1 这 行 缚 定 框架 关闭 事件 到 self.OnClosewindow 方法 。 由 于 这 个 事件 通过 该 框 
架 触 发 且 用 于 帧 ， 所 以 不 需要 传递 一 个 source 参数 。 


#2 x4 R E dE 2) dad SI self.oncloseMe 方法 。 这 样 做 是 
为 了 让 wxPython 能 够 区 分 在 这 个 框架 中 该 按钮 和 其 它 按 钮 所 产生 的 事件 。 


你 也 可 以 使 用 source 参数 来 标识 项 目 ， 即 使 该 项 目 不 是 事件 的 源 。 例 如 ， 你 可 以 
绑 定 一 个 菜单 事件 到 事件 处 理 器 ， 即 使 这 个 菜单 事件 严格 地 说 是 由 框架 所 触发 的 。 
下 例 3.2 演 示 了 绑 定 一 个 菜单 事件 的 例子 : 


#!/usr/bin/env python 
import wx 


class MenuEventFrame(wx.Frame): 

def _init__(self, parent, id): 
wx.Frame.__init__(self, parent, id, 'Menus', 
size-(300, 200) ) 

menuBar = wx.MenuBar() 

menu1 = wx.Menu() 

menultem = menudi.Append(-1, " ") 
menuBar.Append(menui, " ^") 

self.SetMenuBar (menuBar ) 

self.Bind(wx.EVT MENU, self.OnCloseMe, menuItem) 


def OnCloseMe(self, event): 
self.Close(True) 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = MenuEventFrame(parent=None, id--1) 
frame.Show() 

app.MainLoop() 


Bind() 方法 中 的 参数 id 和 id2 使 用 ID 号 指定 了 事件 的 源 。 一 般 情 况 下 这 没 
必要 ， 因 为 事件 源 的 ID 号 可 以 从 参数 source 中 提取 。 但 是 某 些 时 候 直接 使 

用 ID 是 合理 的 。 例 如 ， 如 果 你 在 使 用 一 个 对 话 框 的 ID 号 ， 这 比 使 用 窗口 部 件 更 
容易 。 如 果 你 同时 使 用 了 参数 id 和 id2 ， 你 就 能 够 以 窗口 部 件 的 ID 号 形式 将 
这 两 个 ID 号 之 间 范 围 的 窗口 部 件 绑 定 到 事件 。 这 仅 适 用 于 窗口 部 件 的 ID 号 是 连 
续 的 。 


注意 : Bind() 方法 出 现在 wx.Python2.5 中 ， 以 前 版 本 的 事件 绑 定 中 ， EVT * 
的 用 法 如 同 兄 数 对 象 ， 因 此 你 会 看 到 如 下 的 绑 定 调用 : 


wx.EVT_BUTTON(self, self.button.GetId(), self.OnClick) 
这 个 方式 的 缺点 是 它 不 像 是 面向 对 象 的 方法 调用 。 然 而 ， 这 个 老 的 样式 仍 可 工作 在 
2.5 的 版 本 中 (因为 wx.EVT * 对 象 仍 是 可 调用 的 ) 。 
下 表 3.3 列 出 了 最 常 使 用 的 wx.EvtHandler 的 方法 : 


AddPendingEvent(event) : 将 这 个 event 参数 放 入 事件 处 理 系统 中 。 类 似 
于 ProcessEvent() ， 但 它 实际 上 不 会 立即 触发 事件 的 处 理 。 相 反 ， 该 事件 被 增 
加 到 事件 队列 中 。 适 用 于 线程 间 的 基于 事件 的 通信 。 


Bind(event, handler, source=None, id=wx.ID_ANY, id2=wx.ID_ANY) 


完整 的 说 明 见 3.3.1 节 。 


GetEvtHandlerEnabled()  SetEvtHandlerEnabled( boolean) : # RAH 
器 当前 正在 处 理事 件 ， 则 属性 为 True > SRA False 。 


ProcessEvent(event) :把 event 对 象 放 入 事件 处 理 系 统 中 以 便 立 即 处 理 。 


wxPython 是 如 何 处 理事 件 的 ? 


基于 事件 系统 的 关键 组 成 部 分 是 事件 处 理 。 通 过 它 ， 一 个 事件 被 分 派 到 了 相应 的 用 

于 相应 该 事件 的 一 块 代码 。 在 这 一 节 ， 我 们 将 讨论 wxPython 处 理事 件 的 过 程 。 我 
们 将 使 用 小 段 的 代码 来 跟踪 这 个 处 理 的 步骤 。 图 3.2 显 示 了 一 个 带 有 一 个 按钮 的 简单 
窗口 ， 这 个 按钮 将 被 用 来 产生 一 个 简单 的 事件 。 


S Frame With Button -OE 





Figure 3.2 A simple window 
with mouse events 
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按钮 上 都 可 产生 wxPython 事件 。 


例 3.3 绑 定 多 个 鼠标 事件 


#!/usr/bin/env python 
import wx 
class MouseEventFrame(wx.Frame) : 


def _init_ (self, parent, id): 

wx.Frame.__init__(self, parent, id, 'Frame With Button', 
size=(300, 100) ) 
self.panel = wx.Panel(self) 

self.button = wx.Button(self.panel, 
label="Not Over", pos=(100, 15)) 
self.Bind(wx.EVT BUTTON, self.OnButtonClick, 

self.button) #1 绑 定 按钮 事件 

self.button.Bind(wx.EVT ENTER WINDOW, 


self.OnEnterWindow) 42 绑 定 鼠标 位 于 其 上 事件 
self.button.Bind(wx.EVT LEAVE WINDOW, 
self.OnLeaveWindow) 43 "px Sts BSH 


def OnButtonClick(self, event): 
self.panel.SetBackgroundColour('Green') 
self.panel.Refresh() 


def OnEnterWindow(self, event): 
self.button.SetLabel("Over Me!") 
event.Skip() 


def OnLeaveWindow(self, event): 
self.button.SetLabel("Not Over") 
event.Skip() 


if _name__ == ' main ': 
app - wx.PySimpleApp() 
frame = MouseEventFrame(parent=None, id--1) 
frame.Show() 
app.MainLoop() 


说 明 : 


MouseEventFrame 包含 了 一 个 位 于 中 间 的 按钮 。 在 其 上 融 击 鼠标 将 导致 框架 的 背 
景色 改变 为 绿色 。 。##1 绑 定 了 鼠标 敲 击 事件 。 当 和 鼠标 指针 位 于 这 个 按钮 上 时 ， 按 钮 上 
的 标签 将 改变 ， 这 用 #2 绑 定 。 当 鼠标 离开 这 个 按钮 时 ， 标 签 变 回 原样 ， 这 用 #3 绑 
Z o 
通过 观察 上 面 的 鼠标 事件 例子 ， 我 们 引出 了 在 wxPython 中 的 sill S 问 
题 。#1 中 ， 按 钮 事件 由 附着 在 框架 上 的 按钮 触发 ， 那 么 wxPython 怎么 知道 在 杠 
架 对 象 中 查找 绑 定 而 不 是 在 按钮 对 象 上 呢 ? 在 #2 和 #3 中 ， 鼠 标的 进入 和 离开 事件 被 
全 了 按钮 ， 为 什么 这 两 个 事件 不 能 被 绑 到 框架 上 呢 。 这 些 问题 将 通过 检 
查 wxPython 用 来 决定 如 何 响应 事件 的 过 程 来 得 到 回答 。 


理解 事件 处 理 过 程 


wxPython 的 事件 处 理 过 程 被 设计 来 简化 程序 员 关 于 事件 绑 定 的 创建 ， 使 他 们 不 必 
考虑 哪些 不 重要 的 事件 。 隐藏 在 简化 设计 之 下 的 底层 机 制 是 有 些 复杂 的 。 接 下 来 ， 
我 们 将 跟踪 关于 按钮 敲 击 和 鼠标 进入 事件 的 过 程 。 


图 3.3 显 示 了 事件 处 理 过 程 的 一 个 基本 的 流程 。 短 形 代 表 过 程 的 开始 和 结束 ， 环 形 代 
表 各 种 wxPython 对 象 〈 它 们 是 这 个 过 程 的 一 部 分 ) ， 核 形 代 表 判 断 点 ， 带 条 的 撼 
形 代 表 实 际 的 事件 处 理 方法 。 
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Figure 3.3 Event handling process, starting with the event being triggered, and moving through the 
steps of searching for a handler 


事件 处 理 过 程 开始 于 触发 事件 的 对 象 。 通 常 ， wxPython 首先 在 触发 对 象 中 查找 匹 
配 事件 类 型 的 被 绑 定 的 处 理 器 防 数 。 如 果 找 到 ， 则 相应 的 方法 被 执行 。 否 

则 ， wxPython 将 检查 该 事件 是 否 传送 到 了 上 一 级 的 容器 。 如 果 是 的 话 ， 父 窗口 部 
件 将 被 检查 ， 这 样 一 级 一 级 向 上 寻找 ， 直 到 wxPython 找到 了 一 个 处 理 器 函数 或 到 
达 了 顶级 窗口 。 如 果 事 件 没 有 传播 ， 在 处 理 过 程 完成 之 前 ， wxPython 仍 将 为 了 处 
理 器 函数 而 检查 应 用 程序 对 象 。 


当 事 件 处 理 器 运行 时 ， 过 程 通常 就 结束 了 了。 然而， 函数 可 以 告诉 wxPython 去 继续 
查找 处 理 器 。 下 面 让 我 们 仔细 观察 一 下 这 个 过 程 的 每 一 个 步骤。 我 们 的 每 步 分析 都 
有 图 3.3 的 一 个 相关 略图 。 


第 一 步 ， 创 建 事件 


een ee 


Event | Triggering | 
triggered . object / 
iu 2. 


Figure 3.4 Creation of the event that 
sends focus to the triggering object 


这 个 过 程 开 始 于 事件 被 创建 时 。 在 wxPython 架构 中 已 经 创建 了 大 多 数 的 事件 类 
型 ， 它 们 用 于 响应 特定 的 用 户 动作 或 系统 通知 。 例 如 ， 当 wxPython 通知 “鼠标 移 
进 了 mod. Batt Ra" > EUREN SH RARR KU So EIER RUE SUE 
放 后 被 创建 


事件 首先 被 交 给 创建 事件 的 对 象 。 对 于 按钮 殴 击 ， 这 个 对 象 是 按钮 ; 对 于 鼠标 进 
事件 ， 这 个 对 象 是 所 进入 的 窗口 部 件 。 


第 二 步 ， 确 定 事件 对 象 是 否 被 允许 处 理事 件 。 


事件 处 理 过程 检 查 的 下 一 步 是 看 相关 窗口 部 件 当 前 是 否 被 允许 去 处 理事 件 。 通过 调 
2 wx.EvtHandler 的 SetEvtHandlerEnabled(boolean) 方法 ， 一 个 窗口 可 以 

设置 为 允许 或 不 允许 事件 处 理 。 不 允许 事件 处 理 的 结果 是 该 窗口 部 件 在 事件 处 理 
、 ， 与 该 对 象 关联 的 绑 定 对 象 也 不 会 被 搜索 ， 并 且 在 这 步 中 的 处 理 没有 
向 下 的 分 支 。 


在 事件 处 理 器 级 使 一 个 窗口 部 件 有 效 或 无 效 与 在 用 户 界面 级 ( UI) 不 一 样 。 

在 UI 级 使 一 个 窗口 部 件 无 效 或 有 效 ， 使 用 wx.window 的 方 

法 Disable() 和 Enable() 。 在 UI 级 使 一 个 窗口 部 件 无 效 意味 用 户 不 能 与 这 个 
无 效 的 窗口 部 件 交 互 。 通 常 无 效 的 窗口 部 件 在 屏幕 上 以 灰 化 的 状态 表示 。 一 个 

在 UI 级 无 效 的 窗口 不 能 产生 任何 事件 ; 但 是 ， 如 果 它 对 于 别 的 事件 是 容器 "" 
别 ， 它 仍然 能 够 处 理 它 接受 到 的 事件 。 本 节 的 剩余 内 容 ， 我 们 将 

在 wx.EvtHandler 层面 上 使 用 有 效 和 无 效 ， 这 涉及 到 窗口 部 件 是 否 被 允许 处 理事 
件 。 


对 于 初始 对 象 有 效 或 无 效 状态 的 检查 ， 这 发 生 在 ProcessEvent() 方法 中 ， 该 方 

法 由 wxPython 系统 调用 ih 分 配 机 制 。 o 我们 将 在 事件 处 理 过 程 中 一 

再 看 到 ProcessEvent() 方法 ， 它 是 类 wx.EvtHandler 中 的 方法 ， 它 实际 上 执 
行 图 3.3 所 描绘 的 大 量 事件 处 理 。 如 果 ProcessEvent() 方法 最 后 完成 了 事件 处 

= > M) ProcessEvent() 返回 True 。 如 果 一 个 处 理 器 被 发 现 和 组 合 事件 被 处 

理 ， 则 认为 处 理 完 成 。 处 理 器 函数 可 以 通过 调用 wx.Event 的 Skip() FARE 

式 地 请 求 进 一 步 的 处 理 。 另 处 ， 如 果 初 始 对 象 是 wx ,Window 的 一 个 子 类 ， 那 么 它 
能 够 使 用 一 个 称 为 validator 的 对 象 来 过 滤 事件 。 Validator 将 在 第 九 章 中 详 


» 讨论 。 
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Figure 3.5 
Tests whether the triggering object is enabled 
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Figure 3.6 
Event Verifies that the 
handler triggering object has 
an appropriate binder 
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然后 ProcessEvent() 方法 寻找 一 个 绑 定 器 对 象 ， 该 绑 定 器 对 象 确定 当前 对 象 和 


事件 类 型 之 间 的 绑 定 。 


如 果 对 象 自身 的 绑 定 器 没有 被 找到 ， 那 么 向 上 到 该 对 象 的 超 类 中 去 寻找 。 如 果 一 个 
绑 定 器 对 象 被 发 现 ， wxPython 调用 相关 的 处 理 器 函数 。 在 处 理 器 被 调用 后 ， 该 事 


件 的 事件 处 理 停止 ， 除 非 处 理 器 函数 显 式 地 要 求 作 更 多 的 处 理 。 


在 例子 3.3 中 ， 因 为 在 按钮 对 象 ， 绑 定 器 对 象 wx.EVT ENTER WINDOW ， 和 相关 的 


方法 OnEnterwindow() 之 间 定 义 了 绑 定 ， 所 以 鼠标 进入 事件 被 捕 


获 ， OnEnterWindow() 方法 被 调用 。 由 于 我 们 没有 绑 定 鼠标 敲 击 事件 


wx.EVT_LEFT_DOWN ， 在 这 种 情况 下 ， wxPython 将 继续 搜索 。 
第 四 步 决定 是 否 继续 处 理 
如 图 3.7 所 示 
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Figure 3.7 The event handler calls Skip (), 
and processing continues 


在 调用 了 第 一 个 事件 处 理 器 之 后 ， wxPython 查看 是 否 有 进一步 的 处 理 要 求 。 事 件 
处 理 器 通过 调用 wx.Event 的 方法 Skip() 要 求 更 多 的 处 理 。 如 果 Skip() 方法 
被 调用 ， 那 么 处 理 将 继续 ， 并 且 任何 定义 在 超 类 中 的 处 理 器 在 这 一 步 中 被 发 现 并 执 
行 。 Skip() 方法 在 处 理 中 的 任 一 点 或 处 理 器 所 调用 的 任何 代码 中 都 可 以 被 调 

用 。 Skip() 方法 在 事件 实例 中 设置 一 个 标记 ， 在 事件 处 理 器 方法 完成 

后 ， wxPython 检查 这 个 标记 。 在 例 3.3 中 ， OnButtonClick() 不 调 

用 Skip() ， 因 此 在 那 种 情况 下 ， 处 理 器 方法 结束 后 ， 事 件 处 理 完成 。 在 另 两 个 事 
件 处 理 器 中 调用 了 Skip() ， 所 以 系统 将 保持 搜索 “匹配 事件 绑 定 ”， 最 后 对 于 原 窗 
口 部 件 的 和 鼠标 进入 和 离开 事件 调用 默认 的 功能 ， 如 鼠标 位 于 其 上 的 事件 。 


第 五 步 决定 是 否 展开 如 图 3.8 所 示 
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Figure 3.8 

The event handling process continues looking up the container hierarchy 

if the event is a command event, or is otherwise declared to propagate 
最 后 wxPython 决定 是 否 将 事件 处 理 向 上 展开 到 容器 级 以 发 现 一 个 事件 处 理 器 。 
所 谓 的 容器 级 是 从 一 个 特定 的 窗口 部 件 到 顶层 框架 的 路 径 ， 这 个 路 径 是 从 窗口 部 件 
到 它 的 父 容 器 ， 一 直 向 上 沿 升 。 


如 果 当 前 对 象 没有 关于 该 事件 的 一 个 处 理 器 ， 或 如 果 处 理 器 调用 

了 Skip() ， wxPython 将 决定 是 否 这 个 事件 将 沿 容器 级 向 上 展开 。 如 果 决 定 
不 ， 那 么 在 wx.App 实例 中 再 找寻 一 次 处 理 器 ， 然 后 停止 。 如 果 决 定 是 ， 则 事件 处 
沿 该 窗口 的 容器 级 向 上 搜索 ， 直 到 发 现 适 当 的 绑 定 ， 或 到 达 顶 层 框 架 对 象 ， 或 到 达 
一 个 wx.Dialog SR (即使 这 个 对 话 框 不 是 顶级 的 ) 。 如 果 ProcessEvent() 返 
E] True ， 事 件 则 被 认为 发 现 了 一 个 适当 的 绑 定 ， 这 表示 处 理 完 成 。 到 达 一 

个 wx.Dialog 停止 的 目的 是 防止 父 框架 被 来 自 对 话 框 的 无 关 的 或 未 预期 的 假 事 件 
干扰 。 


一 个 事件 是 否 向 上 展开 至 容器 级 ， 这 是 每 个 事件 实例 的 一 个 动态 属性 ， 尽 管 实 际 上 
默认 值 几乎 总 是 使 用 那 几 个 。 默 认 情 况 ， 只 有 wx.CommandEvent 及 其 子 类 的 实例 
向 上 展开 至 容器 级 。 其 它 的 所 有 事件 不 这 样 做 。 


在 例 3.3 中 ， 按 钮 敲 击 事件 得 到 处 理 。 在 wx.Button 上 涡 击 鼠标 产生 一 个 命令 类 型 
的 事件 wx.EVT_BUTTON 。 由 于 wx.EVT_BUTTON 属于 一 个 wx.CommandEvent ， 
所 以 wxPython Æ 3% 4k 4a sd &P? CREO 9 3563 gat SRR BT OT 8I 
HL RBRES8i5 HT panel 中 没有 相 匹 配 的 绑 定 ， 所 以 又 向 上 至 panel HRA 

口 frame ° Hf frame 中 有 匹配 的 绑 定 ， 所 以 ProcessEvent() 调用 相关 函数 
OnButtonClick() ° 


第 五 步 同 时 也 说 明了 为 什么 鼠标 进入 和 离开 事件 必须 被 绑 定 到 按钮 而 不 是 框架 。 由 
于 鼠标 事件 不 是 wx.CommandEvent 的 子 类 ， 所 以 和 鼠标 进入 和 离开 事件 不 向 上 展开 
至 容器 级 。 如 果 和 鼠标 进 入 和 宛 开 事件 被 绑 定 到 了 框架 ， 那 么 当 和 鼠标 进入 或 离开 框架 
Bt > wxPython Ak KAEH AR BASH o 


在 这 种 方式 中 ， 命 令 事 件 是 被 优先 对 待 的 。 因 为 它们 被 认为 是 高 级 事件 ， 表 示 用 户 
正在 应 用 程序 空间 中 做 一 些 事 ， 而 非 窗口 系统 。 窗 口 系统 类 型 事件 只 对 窗口 部 件 感 
兴趣 ， 而 应 用 级 事件 对 容器 级 。 这 个 规则 不 防 碍 我 们 在 任何 地 方 声 明 绑 定 ， 不 管 被 
绑 定 的 是 什么 对 象 或 什么 对 象 定 义 事件 处 理 器 。 例 如 ， 即 使 这 个 绑 定 的 和 鼠标 融 击 事 
件 针 对 于 按钮 对 和 象 ， 而 绑 定 则 被 定义 在 这 个 框架 类 中 ， 且 调用 这 个 框架 内 的 方法 。 
换 印 话说， 低级 的 非 命 令 事件 通常 用 于 窗口 部 件 或 一 些 系统 级 的 通知 ， 如 鼠标 殴 

击 、 按 键 按 下 、 绘 画 请 求 、 调 整 大 小 或 移动 。 另 一 方面 ， 命 令 事件 ， 如 在 按钮 上 油 
击 息 标 、 或 列表 框 上 的 选择 ， 通 常 由 窗口 部 件 自己 生成 。 例 如 ， 在 适当 的 窗口 部 件 
上 按 下 和 释放 鼠标 后 ， 按 钮 命令 事件 产生 。 


最 后 ， 如 果 遍 历 了 容器 级 后 ， 事 件 没有 被 处 理 ， 那 么 应 用 程序 的 wx. App 对象 调 

用 ProcessEvent() 。 默 认 情 况 下 ， 这 什么 也 不 做 ， 但 是 你 可 以 给 你 

的 wx.App 增加 事件 绑 定 ， 以 便 以 非 标 准 的 方式 来 传递 事件 。 例 如 ， 假 如 你 在 写 一 
个 GUI 构建 器 ， 你 可 能 想 把 你 构建 器 窗口 中 的 事件 传 到 你 的 代码 窗口 中 ， 即 使 它 
们 都 是 顶级 窗口 。 方 法 之 一 是 捕获 应 用 程序 对 象 中 的 事件 ， 并 把 它们 传递 到 代码 窗 
口上 。 


使 用 Skip() 方 法 


事件 的 第 一 个 处 理 器 函数 被 发 现 并 执行 完 后 ， 该 事件 处 理 将 终止 ， 除 非 在 处 理 器 返 
回 之 前 调用 了 该 事件 的 Skip() 方法 。 调 用 Skip() 方法 允许 另外 被 绑 定 的 处 理 
器 被 搜索 ， 搜 索 依据 3.4.1 节 中 的 第 四 步 中 声明 的 规则 ， 因 此 父 类 和 父 窗口 被 搜索 ， 


就 如 同 这 第 一 个 处 理 器 不 存在 一 样 。 在 某 些 情况 下 ， 你 想 继续 处 理事 件 ， 以 便 原 窗 
口 部 件 的 默认 行为 和 你 定制 的 处 理 能 被 执行 。 例 3.4 显 示 了 一 个 使 用 Skip() 的 例 
子 ， 它 使 得 程序 能 够 同时 响应 同一 按钮 上 的 自 标 左 按 键 按 下 和 按钮 敲 击 。 


例 3.4 FF] p v ez EUER ART de di An A 


#!/usr/bin/env python 
import wx 
class DoubleEventFrame(wx.Frame): 


def — init (self, parent, id): 
wx.Frame. init (self, parent, id, 'Frame With Button', 
size=(300, 100)) 
self.panel - wx.Panel(self, -1) 

self.button - wx.Button(self.panel, -1, "Click Me", pos- 
(100, 15)) 
self.Bind(wx.EVT BUTTON, self.OnButtonClick, 

self.button) 41 绑 定 按钮 敲 击 事件 

self.button.Bind(wx.EVT LEFT DOWN, self.OnMouseDown) # 

2 9px RAK eR OS 


def OnButtonClick(self, event): 
self .panel.SetBackgroundColour('Green' ) 
self .panel.Refresh() 


def OnMouseDown(self, event): 
self .button.SetLabel("Again!") 
event.Skip() #3 确保 继续 处 理 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = DoubleEventFrame(parent=None, id--1) 
frame.Show() 
app.MainLoop() 


#1 ÈRIA eens SHB OnButtonClick() 处 理 器 ， 这 个 处 理 器 改变 框架 的 
过 多“ 二 
背景 色 。 


#2 这 行 绑 定 鼠 标 左 键 按 下 事件 到 onMouseDown() 处 理 器 ， 这 个 处 理 器 改变 按钮 的 
标签 文本 。 由 于 鼠标 堪 键 按 下 事件 不 是 命令 事件 ， 所 以 它 必 须 被 绑 定 到 按钮 
( self.button.Bind ) 而 非 框架 ( self.Bind ) ° 


当 用 户 在 按钮 上 融 击 鼠标 时 ， 通 过 直接 与 底层 操作 系统 交互 ， 和 鼠标 左 键 按 下 事件 首 
先 被 产生 。 通 常情 况 下 ， 鼠 标 堪 键 按 下 事件 改变 按钮 的 状态 ， 随 着 鼠标 左 键 的 释 
放 ， 产 生 了 wx.EVT BUTTON 敲 击 事件 。 由 于 行 #3 的 Skip() 语 

4]* DoubleEventFrame 维持 处 理 。 没 有 Skip() 语句 ， 事 件 处 理 规 则 发 现在 #2 
创建 的 绑 定 ， 而 在 按钮 能 产生 wx.EVT BUTTON 事件 之 前 停止 。 由 于 Skip() 的 调 
用 ， 事 件 处 理 照 常 继续 ， 并 且 按 钮 项 击 被 创建 。 


记 住 ， 当 绑 定 低级 事件 时 如 和 鼠标 按 下 或 释放 ， wxPython 期 望 捕获 这 些 低级 事件 以 
便 生 成 进一步 的 事件 ， 为 了 进一步 的 事件 处 理 ， 你 必须 调用 Skip() 方法 ， 否则 进 
一 步 的 事件 处 理 将 被 阻止 。 


在 应 用 程序 对 象 中 还 包含 哪些 其 它 的 属性 ? 


要 更 直接 地 管理 主事 件 循环 ， 你 可 以 使 用 一 些 wx. App 方法 来 修改 它 。 例 如 ， 按 你 
的 计划 ， 你 可 能 想 开 始 处 理 下 一 个 有 效 的 事件 ， 而 非 等 待 DIS 去 开始 处 理 。 
se ， 那么 这 个 特性 是 必 
要 的 ， 通 常 你 不 需要 使 用 这 节 中 的 这 些 方法 ， 但 是 ， 这 些 性 能 有 时 是 很 重要 的 。 


下 表 3.4 列 出 了 你 可 以 用 来 修改 主 循环 的 wx.App 方法 : 


Dispatch() :迫使 事件 队列 中 的 下 一 个 事件 被 发 送 。 通 过 MainLoop() 使 用 或 
使 用 在 定制 的 事件 循环 中 。 Pending() : 如 果 在 wxPython 应 用 程序 事件 队列 

中 有 等 待 被 处 理 的 事件 ， 则 返回 True 。  Yield(onlyIfNeeded = False) : ft 
许 等 候 处 理 的 wxwidgets 事件 在 一 个 长 时 间 的 处 理 期 间 被 分 派 ， 否 则 窗口 系统 将 
被 锁定 而 不 能 显示 或 更 新 。 如 果 等 候 处 理 的 事件 被 处 理 了 ， 则 返回 True ° GMA 
€] False 。 onlyIfNeeded 参数 如 果 为 True ， 那 么 当前 的 处 理 将 让 位 于 等 候 

处 理 的 事件 。 如 果 该 参数 为 False ， 那 么 递归 调用 Yield 是 错误 的 。 这 里 也 有 
一 个 全 局 函数 wx.SafeYield() ， 它 阻止 用 户 在 Yield 期 间 输 入 数据 (这 通过 临 
时 使 用 来 输入 的 窗口 部 件 无 效 来 达到 目的 ) ， 以 免 干扰 Yield 任务 。 


另 一 管理 事件 的 方法 是 通过 定制 的 方式 ， 它 创建 你 自己 的 事件 类 型 ， 以 匹配 你 的 应 
用 程序 中 特定 的 数据 和 窗口 部 件 。 下 一 节 我 们 将 讨论 如 何 创建 你 自己 的 定制 事件 。 


如 何 创建 自己 的 事件 ? 


尽管 这 是 一 个 更 高 级 的 主题 ， 但 是 我 们 将 在 这 里 讨论 定制 事件 。 当 你 第 一 次 阅读 的 
时 候 ， 你 可 以 跳 过 并 且 以 后 再 回 过 头 来 读 。 为 了 要 与 wxPython 提供 的 事件 类 相 
区 别 ， 你 可 以 创建 你 自己 定制 的 事件 。 你 可 以 定制 事件 以 响应 哪些 针对 你 的 应 用 程 
序 的 数据 更 新 或 其 它 改变 ， 此 处 定制 的 事件 必须 负责 你 的 自 定义 数据 。 创 建 定 制 的 
事件 类 的 另 一 个 原因 是 : 你 可 以 针对 所 定制 的 窗口 部 件 ， 使 用 它 自己 独特 的 命令 事 
件 类 型 。 下 一 节 中 ， 我 们 将 看 一 个 定制 窗口 部 件 的 例子 。 


为 一 个 定制 的 窗口 部 件 定 义 一 个 定制 的 事件 


o 
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Figure 3.9 The custom two- 
button widget. Clicking both 
buttons in succession 
triggers a change in the 
window title. 


图 3.9 显 示 了 这 个 窗口 部 件 ， 一 个 画板 ( panel) 包含 了 两 个 按钮 。 自 定义 的 事 
fF TwoButtonEvent 仅 当 用 户 敲 击 了 这 两 个 按钮 之 后 被 触发 。 这 个 事件 包含 了 一 
个 关于 用 户 在 该 部 件 上 融 击 次 数 的 计数 。 


创建 自 定义 事件 的 步骤 : 


1、 定 义 一 个 新 的 事件 类 ， 它 是 wxPython 的 wx.PyEvent 类 的 子 类 。 如 果 你 想 这 
个 事件 被 作为 命令 事件 ， 你 可 以 创建 wx.PyCommandEvent 的 子 类 。 像 许 

多 wxPython 中 的 覆盖 一 样 ， 一 个 类 的 py 版 本 使 得 wxwidget 系统 明白 

用 Python 写 的 覆盖 C++ 方法 的 方法 。 


2、 创 建 一 个 事件 类 型 和 一 个 绑 定 器 对 象 去 绑 定 该 事件 到 特定 的 对 象 。 


3、 添 加 能 够 建造 这 个 新 事件 实例 的 代码 ， 并 且 使 用 ProcessEvent() 方法 将 这 个 
实例 引入 事件 处 理 系统 。 一 旦 该 事件 被 创建 ， 你 就 可 以 像 使 用 其 它 的 wxPython 事 
件 一 样 创建 绑 定 和 处 理 器 方法 。 


下 例 3.5 显 示 了 管理 窗口 部 件 的 代码 : 


import wx 


class TwoButtonEvent(wx.PyCommandEvent ) : #1 定义 事件 
def _ init (self, evtType, id): 

wx.PyCommandEvent. init (self, evtType, id) 
self.clickCount = 0 


def GetClickCount(self): 
return self.clickCount 


def SetClickCount(self, count): 
self.clickCount = count 


myEVT_TWO_BUTTON = wx.NewEventType() #2 创建 一 个 事件 类 型 
EVT_TWO_BUTTON = wx.PyEventBinder(myEVT_TWO_BUTTON, 1) #3 创建 一 
个 绑 定 器 对 象 


class TwoButtonPanel(wx.Panel): 

def _ init__(self, parent, id--1, leftText="Left", 
rightText="Right"): 

wx.Panel. init__(self, parent, id) 

self.leftButton = wx.Button(self, label=leftText) 
self.rightButton = wx.Button(self, label-rightText, 
pos=(100,0)) 

self.leftClick = False 

self .rightClick False 

self.clickCount 0 

#4 下 面 两 行 绑 定 更 低级 的 事件 
self.leftButton.Bind(wx.EVT LEFT DOWN, self.OnLeftClick) 
self.rightButton.Bind(wx.EVT LEFT DOWN, self.OnRightClick) 


def OnLeftClick(self, event): 
self.leftClick - True 


self .OnClick() 
event.Skip() #5 继续 处 理 


def OnRightClick(self, event): 
self.rightClick = True 
self .OnClick() 

event.Skip() #6 继续 处 理 


def OnClick(self): 
self.clickCount += 1 
if self.leftClick and self.rightClick: 
self.leftClick = False 
self .rightClick False 
evt TwoButtonEvent(myEVT TWO BUTTON, self.GetId()) 
#7 创建 自 定 义 事件 
evt.SetClickCount(self.clickCount) # 添加 数据 到 事件 
self.GetEventHandler().ProcessEvent(evt) #8 处 理事 件 


class CustomEventFrame(wx.Frame): 
def _init (self, parent, id): 
wx.Frame. init (self, parent, id, 'Click Count: 0', 
size-(300, 100)) 
panel - TwoButtonPanel(self) 
self.Bind(EVT TWO BUTTON, self.OnTwoClick, panel) #9 Æ 
自 定 义 事 件 


def OnTwoClick(self, event): #10 定义 一 个 事件 处 理 器 函数 
self.SetTitle("Click Count: %s" % event.GetClickCount()) 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = CustomEventFrame(parent=None, id--1) 
frame.Show() 


app.MainLoop() 


说 明 : 


#1 这 个 关于 事件 类 的 构造 器 声明 为 wx.PyCommandEvent 的 一 个 子 类 。 
wx.PyEvent 和 wx.PyCommandEvent 是 wxPython 特定 的 结构 ， 你 可 以 用 来 创 
建新 的 事件 类 并 且 可 以 把 C++ 类 和 你 的 Python 代码 连接 起 来 。 如 果 你 试图 直接 使 
用 wx.Event ， 那 么 在 事件 处 理 期 间 wxPython 不 能 明白 你 的 子 类 的 新 方法 ， 
为 C++ 事件 处 理 不 了 解 该 Python PŽ ° RIR wx.PyEvent ， 一 个 对 
该 Python 实例 的 引用 被 保存 ， 并 且 以 后 被 直接 传递 给 事件 处 理 器 ， 使 得 

该 Python 代码 能 被 使 用 。 


#2 全 局 函数 wx.NewEventType() 的 作用 类 似 于 wx.NewId() ; 它 返 回 一 个 唯一 
的 事件 类 型 ID 。 这 个 唯一 的 值 标 识 了 一 个 应 用 于 事件 处 理 系统 的 事件 类 型 。 


#3 这 个 绑 定 器 对 象 的 创建 使 用 了 这 个 新 事件 类 型 作为 一 个 参数 。 这 第 二 个 参数 的 取 
值 位 于 [0,2] 之 间 ， 它 代表 wxId 标识 号 ， 该 标识 号 用 
于 wx.EvtHandler.Bind() 方法 去 确定 哪个 对 象 是 事件 的 源 。 


#4 为 了 创建 这 个 新 的 更 高 级 的 命令 事件 ， 程 序 必需 响应 特定 的 用 户 事 件 ， 例 如 ， 在 
每 个 按钮 对 象 上 的 和 所 标 左 键 按 下 。 依 据 哪个 按钮 被 敲 击 ， 该 事件 被 绑 定 
到 OnLeftClick() 和 OnRightClick() 方法 。 处 理 器 设置 了 布尔 值 ， 以 表明 按 


#5 #6 Skip() 的 调用 允许 在 该 事件 处 理 完成 后 的 进一步 处 理 。 在 这 里 ， 这 个 新 的 
事件 不 需要 skip 调用 ; 它 在 事件 处 理 器 完成 之 前 被 分 派 了 

( self.OnClick()) 。 但 是 所 有 的 和 鼠标 堪 键 按 下 事件 需要 调用 Skip() ， 以 便 处 
理 器 不 把 最 后 的 按钮 敲 击 挂 起 。 这 个 程序 没有 处 理 按钮 敲 击 事件 ， 但 是 由 于 使 用 

了 Skip() ， wxPython 在 敲 击 期 间 使 用 按钮 敲 击 事件 来 正确 地 绘制 按钮 。 如 果 
被 挂 直 了， 用户 将 不 会 得 到 来 自 按钮 按 下 的 反馈 。 


#7 如 果 两 个 按钮 都 被 敲 击 了 ， 该 代码 创建 这 个 新 事件 的 一 个 实例 。 事 件 类 型 和 两 个 
按钮 的 ID 作为 构造 器 的 参数 。 通 常 ， 一 个 事件 类 可 以 有 多 个 事件 类 型 ， 尽 管 本 例 
中 不 是 这 样 。 

#8 ProcessEvent() 的 调用 将 这 个 新 事件 引入 到 事件 处 理 系统 

中 ， ProcessEvent() 的 说 明 见 3.4.1 节 。 GetEventHandler() 调用 返 

€] wx.EvtHandler 的 一 个 实例 。 大 多 数 情 况 下 ， 返 回 的 实例 是 窗口 部 件 对 象 本 

身 ， 但 是 如 果 其 它 的 wx.EvtHandler() 方法 已 经 被 压 入 了 事件 处 理 器 堆栈 ， 那 么 
返回 的 将 是 堆栈 项 的 项 目 。 


H9 该 自 定 义 的 事件 的 绑 定 如 同 其 它 事件 一 样 ， 在 这 里 使 用 #3 所 创建 的 绑 定 器 。 
#10 这 个 例子 的 事件 处 理 器 取 数 改变 窗口 的 标题 以 显示 敲 击 数 。 


至 此 ， 你 的 自 定义 的 事件 可 以 做 任何 预先 存在 的 wxPython 事件 所 能 做 的 事 ， 比 如 
创建 不 同 的 窗口 部 件 ， 它 们 响应 同样 的 事件 。 创 建 事件 是 wxPython 的 定制 的 一 个 
重要 部 分 。 
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1^ wxPython 应 用 程序 使 用 基于 事件 的 控制 流 。 应 用 程序 的 大 部 分 时 间 花 费 在 一 
个 主 循环 中 ， 等 待 事件 并 分 派 它们 到 适当 的 处 理 器 函数 。 


2、 所 有 的 wxPython 事件 是 wx.Event 类 的 子 类 。 低 级 的 事件 ， 如 鼠标 敲 击 ， 被 
用 来 建立 高 级 的 事件 ， 如 按钮 敲 击 或 菜单 项 选择 。 这 些 由 wxPython 窗口 部 件 引起 
的 高 级 事件 是 类 wx.CommandEvent 的 子 类 。 大 多 的 事件 类 通过 一 个 事件 类 型 字段 
被 进一步 分 类 ， 事 件 类 型 字段 区 分 事件 。 


3、 为 了 捕获 事件 和 有 函数 之 间 的 关联 ， wxPython 使 用 类 wx.PyEventBinder 的 
实例 。 类 wx.PyEventBinder 有 许多 预定 义 的 实例 ， 每 个 都 对 应 于 一 个 特定 的 事 
件 类 型 。 每 个 wxPython 窗口 部 件 都 是 类 wx.EvtHandler 的 子 类 。 

类 wx.EvtHandler 有 一 个 方法 Bind() ， 它 通常 在 初始 化 时 被 调用 ， 所 带 参 数 是 
一 个 事件 绑 定 器 实例 和 一 个 处 理 器 函数 。 根 据 事件 的 类 型 ， 别 的 wxPython 对 象 
的 ID 可 能 也 需要 被 传递 给 Bind() 调用 。 


4、 事 件 通常 被 发 送 给 产生 它们 的 对 象 ， 以 搜索 一 个 绑 定 对 象 ， 这 个 绑 定 对 象 绑 定 
事件 到 一 个 处 理 器 通 数 。 如 果 事 件 是 命令 事件 ， 这 个 事件 沿 容器 级 向 上 传递 直到 一 
个 窗口 部 件 被 发 现 有 一 个 针对 该 事件 类 型 的 处 理 器 。 一 旦 一 个 事件 处 理 器 被 发 现 ， 
对 于 该 事件 的 处 理 就 停止 ， 除 非 这 个 处 理 器 调用 了 该 事件 的 Skip() 方法 。 你 可 以 
允许 多 个 处 理 器 去 响应 一 个 事件 ， 或 去 核查 该 事件 的 所 有 默认 行为 。 主 循环 的 某 些 
方面 可 以 使 用 wx,App 的 方法 来 控制 。 


5、 在 wxPython 中 可 以 创建 自 定义 事件 ， 并 作为 定制 ( 自 定义 ) 的 窗口 部 件 的 行 
为 的 一 部 分 。 自 定义 的 事件 是 类 wx.PyEvent 的 子 类 ， 自 定义 的 命令 事件 是 

类 wx.PyCommandEvent 的 子 类 。 为 了 创建 一 个 自 定义 事件 ， 新 的 类 必须 被 定义 ， 
并 且 关 于 每 个 事件 类 型 (这 些 事件 类 型 被 这 个 新 类 所 管理 ) 的 绑 定 器 必须 被 创建 。 
最 后 ， 这 个 事件 必须 在 系统 的 茶 处 被 生成 ， 这 通过 经 由 ProcessEvent() 方法 传 
递 一 个 新 的 实例 给 事件 处 理 器 系统 来 实现 。 

在 本 章 中 ， 我 们 已 经 讨论 了 应 用 程序 对 象 ， 它 们 对 于 你 的 wxPython 应 用 程序 是 最 
重要 的 。 在 下 一 章 ， 我 们 将 给 你 看 一 个 有 用 的 工具 ， 它 是 用 wxPython 写成 的 ， 它 
将 帮助 你 使 用 wxPython 进行 开发 工作 。 


wx 用 PyCrust 使 得 wxPython 更 区 处 理 


. M PyCrustt 41wxPython € Z 4b 3 
i， 如 何 ww A 
i，PyCrust 的 有 用 特性 是 什么 

ij， 自 动 完成 

让 调用 提示 和 参数 默认 
iii, AAR 

iv. Python 

v. 命令 重 调用 

vi. 3 ta Heth Wb 
vii. 标准 shell 环 境 


viii. 动态 更 新 
ili. PyCrust 
i Namespace 标 签 
ii. Display 标 签 


iii. Session 标 签 

iv. Dispatcher 
iv， 如 何 将 PyCrust 应 用 于 wxPython 应 用 程序 
v. 在 Py 包 中 还 有 其 它 什 么 ? 

i， 使 用 GUI 程序 工作 

i 使 用 支持 模块 工作 
Vi， 如 何在 wxPython 中 使 用 Py 包 中 的 模块 ? 
Viil， 本 章 小 结 


PyCrust 是 一 个 图 形 化 的 shell 程序 ， 使 用 wxPython 写成 ， 它 可 以 用 来 帮助 
你 分 析 你 的 wxPython 程序 。 


为 何 称 它 为 PyCrust ?这 是 因为 当 Patrick O’Brien 使 用 wxPython 创建 一 个 
交互 式 的 Python shell 时 ， PyShell 已 被 使 用 了 ， 所 以 选用 了 PyCrust 这 
个 名 字 。 

PyCrust 是 Py 包 中 的 一 部 分 ，Py 包 目 前 被 包含 在 wxPython 中 。 这 

^ Py 包 还 包含 了 其 它 相关 功 能 的 程序 > 这 包括 PyFilling , PyAlaMode , 
PyAlaCarte ,和 PyShell 。 这 些 程序 每 个 都 是 想 成 为 融 图 形 人 化、 点击 环境 

、 wxPython 的 交互 、 内 省 运行 特点 为 一 体 。 但 是 PyCrust 表现 最 完善 。 


在 这 章 中 ， 我 们 将 说 明 PyCrust 和 那些 相关 程序 都 干 些 什么 ， 还 有 ， 你 如 何 使 用 
它们 才能 使 得 你 用 wxPython 工作 得 更 流畅 。 我 们 以 谈论 普通 的 Python 

shell 作为 开始 ， 然 后 专门 针对 PyCrust ， 最 后 我 们 将 涉及 Py 包 中 剩 下 的 程 
序 o 


如 何 与 WxPython 程 序 交互 ? 


与 其 它 编程 语言 相 比 ， Python 的 一 个 显著 的 特点 是 你 可 以 以 两 种 方式 来 使 用 它 : 
你 可 以 用 它 来 运行 存在 的 使 用 Python 语言 写 的 程序 ， 或 从 命令 提示 符 来 交互 地 运 
行 Python 。 交 互 地 运行 Python 如 同 与 python 解释 器 会 话 。 


在 下 例 4.1 中 ， 我 们 从 命令 行 启 动 Python ， 并 键入 一 些 数学 运算 。 Python 启动 
后 显示 几 行 信息 ， 然 后 是 它 的 主 提 示 符 ''。 当 你 键入 的 东西 要 求 额外 的 代码 行 


一 ški €! 


时 ， Python 显示 它 的 次 提示 符 '...'。 


例 4.1 简单 的 Python 交互 式 会 话 


$ Python 

Python 2.3.3 (#1, Jan 25 2004, 11:06:18) 

[GCC 3.2.2 (Mandrake Linux 9.1 3.2.2-3mdk)] on linux2 

Type "help", "copyright", "credits" o "license" for more informa 
tion. 


2X2 
4 
Taste Eb 
42 
556 
125 
for n in range(5): 
print n* 9 
0 
9 
18 
27 
36 


交互 式 的 Python 不 仅仅 是 一 个 好 的 桌面 计算 器 ， 它 也 是 一 个 好 的 学 习 工 具 ， 因 为 
它 提供 了 及 时 的 反馈 。 当 你 有 疑问 时 ， 你 可 以 运行 Python ， 键 入 几 行 试验 性 的 代 
码 ， 看 Python 如 何 反 应 ， 据 此 调整 你 的 主要 代码 。 学 习 Python 或 学 习 现 有 

的 Python 代码 是 如 何 工作 的 ， 最 好 的 方法 之 一 就 是 交互 式 地 调试 。 


PyCrust 配置 了 标准 的 Python shell 


当 你 交互 式 的 使 用 Python 工作 时 ， 你 工作 在 一 个 称 为 Python shell 的 环境 
中 ， 它 类 似 于 其 它 的 shell 环境 ， 如 微软 平台 的 Dos 窗口 ， 或 类 unix 系统 
的 bash 命令 行 。 


所 有 Python shell 中 最 基本 的 是 例 4.1 中 所 出 现 的 ， 它 是 你 从 命令 行 局 

动 Python 时 所 见 到 的 。 虽 然 它 是 一 个 有 用 的 shell ， 但 是 它 基 于 文本 的 ， 而 非 
图 形 化 的 ， 并 且 它 不 提供 快捷 方式 或 有 帮助 的 提示 。 有 几 个 图 形 化 的 Python 
shell 已 经 被 开发 出 来 了 ， 它 们 提供 了 这 些 额外 的 功能 。 最 著名 的 是 IDLE ， 它 
是 Python 发 布 版 的 标准 部 分 。 IDLE 如 下 图 4.1 所 示 : 


*Python Shell* 


File Edit Shell Debug Options Windows Help 








Python 2.4.3 (#69, Mar 29 2006, 17:3 
5:34) [MSC v.1310 32 bit (Intel)] on 
win32 

Type "copyright", "credits" or "lice 
nse()" for more information. 
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Personal firewall software may w 
arn about the connection IDLE 

makes to its subprocess using th 
is computer's internal loopback 

interface. This connection is n 
ot visible on any external 

interface and no data is sent to 


or received from the Internet. 
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IDLE 1.1.3 


>>> int { 
int(x[, base]) -> integer 
= 


Ln: 12|Col: 8 
IDLE 看 起 来 很 像 命令 行 Python shell ， 但 是 它 有 额外 的 特性 如 调用 提示 。 


其 它 的 Python 开发 工具 ， 如 Pythonwin 和 Boa Constructor ， 包 括 了 类 似 
于 IDLE 中 的 图 形 化 Python shell 。 虽 然 每 种 工具 的 shell 各 有 一 些 有 用 的 
特性 ， 如 命令 再 调用 ( recall) 、 自 动 完成 、 调 用 提示 ， 但 是 没有 一 个 工具 完整 包 
含 了 所 有 的 特性 。 在 这 种 情况 下 ， PyCrust 产生 了 ， PyCrust 的 目的 之 一 就 是 
提供 所 有 现存 的 Python shell 的 特性 。 


创建 PyCrust 的 另 一 个 动机 是 : 使 用 一 个 GUI 工具 包 所 写 的 代码 不 能 工作 在 另 
一 个 不 同 的 GUI 工具 包 上 。 例 如 ， IDLE 是 用 Tkinter 写 的 ， 而 不 

是 wxPython 。 由 于 这 样 ， 如 果 你 试图 在 IDLE 的 Python shell 中 引入 和 使 
用 wxPython 模块 ， 那么 你 将 陷入 wxPython 的 事件 循环 与 Tkinter 事件 循环 
间 的 冲突 ， 结 果 将 导致 程序 的 冻结 或 崩溃 。 


事实 上 ， 这 两 个 工具 包 将 在 控制 事件 循环 上 产生 冲突 。 因 此 ， 如 果 你 使 

用 wxPython 模块 工作 时 想 要 内 省 运行 特性 ， 你 的 Python shell 必须 是 
用 wxPython 写 的 。 由 于 没有 现存 的 Python shell 支持 完整 的 特 

性 ， PyCrust 被 创建 来 填补 这 种 需要 。 


PyCrust 的 有 用 特性 是 什么 ? 


现在 ， 我 们 将 关注 Pycrust 提供 的 shell 的 一 些 特性 。 PyCrust 的 shell 看 
起 来 有 些 熟悉 ， 这 是 因为 它 也 显示 了 如 同 命令 行 Python shell 相同 的 信息 行 和 
提示 符 。 下 图 4.2 显 示 了 一 个 打开 着 的 Pycrust 的 屏幕 : 


SS PyCrust 
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mPyCrust 0.9.5 - The Flakiest Python Shell 

ZPython 2.4.3 (#69, Mar 29 2006, 17:35:34) [MSC 
v.1310 32 bit (Intel)] on win32 

mlype "help", "copyright", "credits" or 
"license" for more information. 
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Namespace | Display | Calltip History | Dispatcher | 
locals locals () 














Type: «type 'dict'» 


Value: {'shell': <wx.py. 
shell.Shell: proxy of C++ X 
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你 应 该 注意 一 下 这 个 Pycrust 框架 ， 它 包含 了 一 个 wx.Splitterwindow 控件 ， 
框架 被 分 成 两 个 区 域 : 上 部 的 区 域 看 起 来 像 通常 的 Python shell ; 底部 的 区 域 
包含 了 一 个 Notebook 控件 ， 这 个 控件 包含 了 不 同 的 标签 ， 默 认 标 签 显示 的 信息 是 
有 关 当 前 的 名 字 空 间 的 。 上 部 区 域 是 PyCrust shell ， 它 有 几 个 有 用 的 特性 ， 
我 们 将 在 下 面 几 节 讨 论 。 


自动 完成 


当 你 在 一 个 对 象 名 后 键入 一 点 号 时 将 引发 自动 完成 功能 。 PyCrust 将 按 字 母 顺序 
显示 关于 该 对 象 的 所 有 已 知 的 属性 的 一 个 列表 。 当 你 在 点 号 后 输入 字母 时 ， 在 列表 
中 的 高 亮 选项 将 改变 去 匹配 你 所 输入 的 字母 。 如 果 高 亮 选项 正 是 你 所 要 的 ， 这 时 按 
下 Tab 4@° PyCrust 将 为 你 补 全 该 属性 名 的 其 余部 分 。 


在 下 图 4.3 中 ， PyCrust 显示 一 个 字符 串 对 象 的 属性 的 列表 。 这 个 自动 完成 的 列表 
包含 了 该 对 象 的 所 有 属性 和 方法 。 


图 4.3 


第 四 章 用 PyCrust 使 得 wxPython 更 易 处 理 


PyCrust 


PyCrust 0.9.5 
Python 2.4.3 || Cancer 
v.1310 32 bit count 
Type "help", " or 
"license" for decode 


>>> s="hello" | Encode 
So a endswith 


expandtabs 
find 
index 


Shell 
85:34) [MSC 


capitalize 








locals () 
Type: «type 'dict'» 


Value: í'pp': <bound 
method Displav.setItem of 








调用 提示 和 参数 默认 


当 你 在 一 个 可 调用 的 对 象 名 后 键入 左 括 号 时 ， PyCrust 显示 一 个 调用 提示 窗口 
(如 图 4.4) ， 该 窗口 包含 了 所 能 提供 的 参数 信息 和 文档 字符 串 〈 如 果 可 调用 对 象 中 
定义 了 文档 字符 串 的 话 ) 。 

可 调用 对 象 可 以 是 函数 、 方 法 、 内 建 的 或 类 。 可 调用 对 象 的 定义 都 可 以 有 参数 ， 并 

且 可 以 有 用 来 说 明 功 能 的 文档 字符 串 ， 以 及 返回 值 的 类 型 。 如 果 你 知道 如 何 使 用 该 

可 调用 对 象 ， 那 么 你 可 以 忽略 调用 提示 并 继续 键入 。 

图 4.4 

= PyCrust 一 | 口 | x 
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>>> s.capitalize || 








Value: {'pp': <bound method 
Disvlav.setItem of <wx.nv.crust 
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当 你 在 shell 中 键入 代码 时 ， PyCrust 根据 它 的 重要 性 改变 文本 的 颜色 。 例 
如 ， Python 的 关键 词 用 一 种 闫 色 显 示 ， 原 义 字 符 串 用 另 一 种 颜色 ， 注 释 用 另 一 种 
颜色 。 这 就 使 得 你 可 以 通过 颜色 来 确认 你 的 输入 是 否 有 误 。 


Python 


帮助 


PyCrust 完整 地 提供 了 关于 Python 的 帮助 功能 。 Python 的 帮助 功能 显示 了 几 
乎 所 有 Python 方面 的 信息 ， 如 下 图 4.5 所 示 


图 4.5 





PyCrust 
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1PyCrust 0.9.5 - The Flakiest Python Shell 

ZPython 2.4.3 (#69, Mar 29 2006, 17:35:34) [MSC v.1310 32 bit (Intel)] 
on win3z 

Type "help", "copyright", "credits" or "license" for more information. 

4>>> help 

5 Type helpí) for interactive help, or helpí(object) for help about 
object. 

6>>> help() 

7 

8 Welcome to Python 2.4! This is the online help utility. 

Ej 

lO If this is your first time using Python, you should definitely check 
out 

llthe tutorial on the Internet at http://www.python.org/doc/tut/. 

12 

13 Enter the name of any module, keyword, or topic to get help on writing 

l4 Python programs and using Python modules. To quit this help utility 
and 

15 return to the interpreter, just type "quit". 

16 

17 To get a list of available modules, keywords, or topics, type 
"modules", 

is "keywords", or "topics". Each module also comes with a one-line 
summary 

l9 of what it does; to list the modules whose summaries contain a given | 










Namespace | Display | Calltip | History | Dispatcher | 
locals 
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locals () 



















Type: «type 'dict'» 


zl 


Python 的 帮助 功能 提供 了 另外 一 个 提示 符 ( help) "在 使 用 了 help 之 后 ， 你 
可 以 通过 在 help 提示 符 之 后 键入 quit 来 退出 帮助 模式 ， 返 回 到 通常 
的 Python 提示 符 ( )。 


命令 重 调用 


在 PyCrust shell 中 有 多 种 方法 可 以 用 来 减少 重复 输入 。 它 们 大 都 通过 捕获 你 
先前 的 键入 来 实现 ， 如 果 有 必要 ， 你 可 以 修改 所 捕获 的 内 容 ， 之 后 它们 将 之 发 送 
给 Python 解释 器 。 


例如 ， PyCrust 维护 着 当前 会 话 中 你 所 键入 的 所 有 命令 的 一 个 历史 记录 。 你 可 以 
从 命令 历史 记录 中 重 调用 你 先前 键入 的 任何 Python 命令 (一 行 或 多 行 ) ° FÀ 
4.1 显 示 了 一 个 关于 该 功能 的 快捷 键 列表 。 


Ctrl + 上 箭头 : 获取 前 一 个 历史 项 alt +P: 获取 前 一 个 历史 项 Ctrl €T 
头 : 获取 下 一 个 历史 项 Alt +N: 获取 下 一 个 历史 项 shift + 上 箭头 : 插入 前 一 
个 历史 项 Shift + 下 箭头 : 插入 下 一 个 历史 项 F8 :历史 项 命令 补 全 (键入 先前 
命令 的 少量 字符 并 按 F8 ) Ctrl + Enter :在 多 行 命令 中 插入 新 行 


正如 你 所 看 到 的 ， 这 儿 有 不 同 的 命令 用 于 获取 和 插入 加 命令 ， 它 们 通 
过 PyCrust 如 何 处 理 当前 wxPythob 提示 符 中 所 键入 的 文本 被 区 分 。 要 替换 你 的 
键入 或 插入 一 个 四 的 命令 ， 可 以 使 用 快捷 键 来 获取 或 插入 一 个 历史 项 。 


插入 一 行 到 一 个 多 行 命令 中 的 工作 与 持 入 到 一 单行 命令 不 同 。 要 插入 一 行 到 一 个 多 
行 命令 ， 你 不 能 只 按 Enter 键 ， 因 为 这 样 将 把 当前 的 命令 发 送 给 Python 解释 
Bo BRYA Ke EF Ctrl + Enter 来 插入 一 个 中 断 到 当前 行 。 如 果 你 处 于 
行 尾 ， 那 么 一 个 空 行 被 插入 当前 行 之 后 。 这 个 过 程 类 似 于 你 在 一 个 通常 的 文本 编辑 
中 剪 切 和 粘 帖 文本 的 方法 。 


最 后 一 种 重 调用 命令 的 方法 是 简单 地 将 光标 移 到 想 要 使 用 的 命令 ， 然 后 
按 Enter 键 。 PyCrust 复制 该 命令 到 当前 的 Python 提示 符 。 然 后 你 可 以 修改 
该 命令 或 按 Enter 键 以 将 该 命令 提交 给 解释 器 。 


快捷 键 让 你 可 以 快速 地 开发 代码 ， 并 做 每 步 的 测试 。 例 如 ， 你 可 以 定义 一 个 新 
的 Python 类 ， 创 建 该 类 的 一 个 实例 ， 并 看 它 的 行为 如 何 。 然 后 ， 你 可 以 返回 到 这 
个 类 的 定义 ， 增 加 更 多 的 方法 或 编辑 已 有 的 方法 ， 并 创建 一 个 新 的 实例 。 通 过 这 样 
的 反复 ， 你 可 以 将 你 的 类 的 定义 做 得 足够 好 ， 然 后 将 它 粘 帖 到 你 的 源 代码 中 。 
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你 可 能 想 重用 在 shell 中 已 开发 的 代码 ， 而 避免 重新 键入 。 有 了 时， 你 可 能 找到 一 
些 样 例 代 码 〈 可 能 来 自在 线 的 教程 ) ， 你 想 把 它 用 到 一 个 Python 
shell T » PyCrust 提供 了 一 些 简 单 的 剪 切 和 粘贴 选项 ， 列 表 于 下 表 4.2 


Ctrl +C: 复制 所 选 的 文本 ， 去 掉 提 示 符 Ctrl + Shift +C: 复制 所 选 的 文 
本 ， 保 留 提示 符 Ctrl +X: 剪 切 所 选 的 文本 Ctrl +V :粘贴 自 剪 贴 板 
Ctrl + Shift +V :粘贴 自 剪贴 板 的 多 个 命令 并 运行 


粘贴 的 另 一 个 特性 是 : Pycrust 从 所 粘贴 到 PyCrust shell 中 的 代码 中 识别 
并 自动 去 掉 标准 的 Python 提示 符 。 这 使 得 复制 教程 或 email 信息 中 的 例子 代 
码 ， 把 它 粘贴 到 PyCrust 中 ， 并 测试 它 变 得 简单 了 ， 省 去 了 手工 的 清理 。 

某 些 时 候 ， 当 你 复制 代码 时 ， 你 可 能 想 去 除 PyCrust 提示 符 ， 如 当 你 复制 代码 到 


你 的 源 文件 中 时 。 另 一 些 时 候 ， 你 可 能 想 保留 这 个 提示 符 ， 如 录 你 复制 例子 到 一 个 
文档 中 ， 或 把 它 发 送 到 一 个 新 闻 组 。 当 从 shell 复制 时 ， PyCrust 对 这 两 种 情 


况 都 提供 了 支持 。 


标准 shell 环 境 


在 wxPython 环境 中 ， PyCrust 的 行为 尽 可 能 地 与 命令 行 的 Python 

shell 相同 。 不 同 的 是 ， 一 旦 Python 代码 被 输入 到 了 PyCrust shell 中 ， 
就 没有 办 法 来 中 断 该 代码 的 运行 。 例 如 ， 假 定 你 在 PyCrust 中 写 了 一 个 无 限 循 
环 ， 如 下 所 示 : 


e while True: 
print " Hello "... 


在 你 按 下 Enter 之 后 ， 上 面 的 代码 被 传送 到 Python 解释 器 ， PyCrust 停止 响 
应 。 要 中 断 这 个 无 限 的 循环 ， 必 须 关闭 pycrust 程序 。 这 个 缺点 是 与 命令 行 
的 Python shell 对 比 而 言 的 。 命 令 行 的 Python shell RY TARRY 
断 ( Ctrl +C) 的 能 力 。 在 命令 行 的 Python shell 中 你 会 看 到 如 下 的 行为 : 


while True: 
print "Hello" 

Hello 

Hello 

Hello 

Hello 

Hello 

Hello 

Hello 

Hello 

Hello 

Hello 

Hello 

Traceback (most recent call last): 

File " stdin ", line 2, in ? 

KeyboardInterrupt 


在 GUI 环境 中 的 事件 处 理 的 本 质 ， 使 得 设计 出 能 够 让 PyCrust 中 断 一 个 无 限 循 
HA shell 提示 符 中 键入 的 长 时 间 运 行 的 代码 序列 的 方法 有 很 大 的 不 同 。 将 来 
的 PyCrust 版 本 可 能 会 提供 对 这 个 缺点 的 一 个 解决 办 法 。 幸 运 的 是 ， 

在 PyCrust 和 标准 命令 shell 之 间 只 有 这 一 个 不 同 点 。 在 其 它 方面 ， PyCrust 
shell 和 命令 行 的 Python shell 工作 的 完全 一 样 。 


动态 更 新 


当 你 在 运行 PyCrust 时 ， PyCrust 的 shell 的 所 有 特性 都 是 动态 地 被 更 新 的 ， 
这 意味 着 ， 诸 如 “自动 完成 "和 "调用 提示 ?等 特性 是 有 效 的 ， 即 使 是 在 shell 提示 符 
中 定义 的 对 象 。 例 如 图 4.6 和 4.7 所 显示 的 会 话 ， 那 么 我 们 定义 并 使 用 了 一 个 类 。 


$ v9 A PyCrustt# #+wxPython € Z Ab 3€ 


在 图 4.6 中 ， PyCrust 为 新 类 显示 了 自动 完成 选项 。 图 4.6 
EDT = = MEE] 








>>> class Person: 
def — init (self, name, age): 
"recreate a person instance." 
self.name-name 
self.age=age 
def intro(self): 
"""return a personal introdouction string.""" 
vere return "my name is $s and i am $s years old." 
self.name,self.age) 


>>> p=Person('Bob',16) 


. module . 
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在 图 4.7 中 ， PyCrust 显示 了 关于 类 所 定义 的 新 的 方法 的 调用 提示 。 HAT 


PyCrust 0.9.5 - The Flakiest Python Shell 
Python 2.4.3 (#69, Mar 29 2006, 17:35:34) [MSC v.1310 32 
bit í(Intel)] on win32 
Type "help", "copyright", "credits" or "license" for more 
information. 
>>> class Person: 

def intro(self): 

vrerThere show calltip""" 


>>> p=Person 


>>> p.intro (self) 








PyCrust 


notebook 的 标签 是 干什么 的 ? 


PyCrust 界面 的 下 半 部 是 一 个 notebook 控件 ， notebook 控件 包括 了 几 个 带 
有 有 用 信息 的 标签 。 PyCrust 开始 时 ， 你 所 看 到 的 标签 是 * Namespace "标签 。 
Namespace 标 位 
如 图 4.8 所 示 ， Namespace 标签 又 被 用 wx.Splitterwindow 控件 分 成 两 部 分 。 左 
边 包 含 一 个 树 控 件 ， 它 显示 当前 的 名 字 空 间 ， 而 右边 显示 在 名 字 空 间 树 中 当前 被 选 
择 的 对 象 的 细节 。 


图 4.8 





SPyCrust 


File Edit View Options Help 





Type "help", "copyright", "credits" or 
"license" for more information. 


4>>> import wx 
§>>> dir{) | 
mC’ builtins _'; ' doc ', ' file ', 

' name ^'", 'filling', 'notebook', 'pp', 


'shell', 'wx'] 


7» | 





locals 0) 
builtins__ 


一 -。 : «type 'module'> 























: «module 'wx' 











notebook 





P 'C:\PYTHON2 4 lib\site-pa 
shell ckages) wx-2.6-msw-ansi\ w 
x\ init .pyc'> 




















—all_ 
builtins__ 
class — 
delattr__ 


. diet — 











Source Code: 








doc . 
docfilter . 














file. 
__getattribute__ 
. hash — 
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名 字 空 间 树 呈现 一 个 关于 在 当前 名 字 空 间 中 所 有 对 象 的 层次 关系 的 视图 。 如 果 你 运 
ff Python 的 内 建 函 数 locals() ， 这 些 对 象 将 作为 返回 结果 。 在 图 4.8 中 ， 我 们 
已 经 导入 了 wx 包 并 在 名 字 空 间 树 中 选择 了 它 。 右 边 显示 了 所 选择 的 项 目的 名 字 ， 
它 的 类 型 和 它 的 当前 值 。 如 果 对 象 有 与 之 相关 联 的 源 代码 ， PyCrust 也 将 显示 出 
来 。 这 里 ， wx 是 一 个 wxPython 包 ， 所 以 PyCrust 显示 _ init__.py 文件 的 
源 代 码 ， 该 文件 位 于 wx 目录 中 。 


右边 显示 的 第 一 行 是 左边 所 选择 的 对 象 的 全 名 ， 你 可 以 把 它 复制 并 粘贴 
到 PyCrust shell 或 你 的 应 用 程序 源码 中 。 例 如 ， 我 们 在 Pycrust 中 引 
A locale 模块 并 选择 名 字 空 间 树 中 locale / encoding alias / en ' > #3 


就 显示 了 所 选 对 象 的 完整 名 ， 你 可 以 把 它 复制 并 粘贴 到 Pycrust shell 中 ， 如 
下 所 示 : 


import locale 
locale.encoding alias['en'] 
' I508859-1' 


ik Y ^ pycrust 给 我 们 提供 了 一 个 全 名 ( 

locale.encoding alias [ en ]) ， 它 使 用 Python 的 索引 ([ en J) 来 引 

用 encoding alias 目录 中 的 指定 项 目 。 这 个 机 制 同样 适用 于 列表 ( list) 。 如 
果 你 在 名 字 空 间 树 中 发 现 了 你 想 用 在 你 的 代码 中 的 东西 ， 那 么 Pycrust 给 了 你 这 
精确 语法 去 完成 这 个 任务 。 


Display 标 签 


e Display 标签 中 用 于 显示 一 个 对 象 。 PyCrust A-*+AR BK pp() ， 这 
个 函数 使 用 Python 的 pprint 模块 为 显示 一 个 对 象 。 使 用 中 不 需要 显 式 地 
引入 和 重复 使 用 pprint > Æ Display 中 ， 这 些 信息 随 对 象 的 更 新 而 每 次 更 
新 。 


例如 ， 如 果 我 们 在 PyCrust shell 中 有 一 个 列表 ， 我 们 要 在 Display 标签 中 
显示 它 的 内 容 ， 我 们 可 以 在 PyCrust shell 中 使 用 pp() ， 然 后 列表 的 内 容 就 
显示 在 Display 标签 中 了 。 以 后 每 当 我 们 改变 了 列表 的 内 容 ， Display 标签 中 
的 内 容 随 即 改变 。 


Calltip 标签 显示 了 在 Python shell 中 最 近 调 用 提示 的 内 容 。 如 果 你 的 调用 
要 求 大 量 的 参数 ， 那 么 你 可 以 选择 Calltip 标签 。 当 使 用 wxPython 包 时 ， 存 在 
着 大 量 的 类 ， 这 些 类 有 许多 方法 ， 这 些 方法 又 要 求 许多 参数 。 例 如 ， 为 了 创建 一 
人 wx.Button ， 你 可 能 要 提供 和 八 个 参数 ， 有 一 个 是 必须 提供 的 ， 其 它 七 个 有 默认 
的 值 。 Calltip 标签 显示 了 关于 wx .Button 构造 器 的 细节 ， 如 下 所 示 : 


. init (self, Window parent, int id=-1, String label-EmptyStrin 
g, 
Point pos=DefaultPosition, Size size=DefaultSize, 
long style=0, Validator validator=DefaultValidator, 
String name=ButtonNameStr) - Button 


Create and show a button. The preferred way to create standard b 
uttons 

is to use a standard ID and an empty label. In this case wxWiget 
s will 

automatically use a stock label that corresponds to the ID given 
ern 

addition, the button will be decorated with stock icons under GT 
K+2. 


由 于 wxPython 的 类 实际 上 是 封装 的 C++ 的 类 ， 所 以 调用 提示 信息 完全 基于 类 的 文 
档 字符 串 。 它 们 显示 了 底层 C++ 类 所 需要 的 参数 和 类 型 信息 。 对 于 完全 
用 Python 语言 定义 的 对 象 ， PyCrust 检查 它们 以 确定 它 的 参数 特性 。 


Je 


Session? & 


e Session 标签 是 一 个 简单 的 文本 控件 ， 它 列 出 了 在 当前 shell 会 话 中 所 键 
入 的 所 有 命令 。 这 使 得 剪 切 和 粘贴 命令 以 用 在 别处 更 为 简单 。 


Dispatcher 
E; 


E 


PyCrust 包括 了 一 个 名 为 dispatcher 的 模块 ， 它 提供 了 在 一 个 应 用 程序 中 联系 
对 象 的 机 制 。 PyCrust 使 用 dispatcher 来 维持 它 的 界面 的 更 新 ， 主 要 是 在 命令 
从 shell 传送 到 Python 解释 器 时 。 图 4.9 中 的 标签 列 出 了 关于 信 
号 经 过 分 配 机 制 后 的 路 由 。 当 使 用 Pycrust 工作 时 ， 这 是 它 的 主要 用 处 。 


图 4.9 





ZPyCrust 
File Edit View Options Help 


lPyCrust 0.9.5 - The Flakiest Python Shell ^ 
ZPython 2.4.3 (#69, Mar 29 2006, 17:35:34) [MSC v.1310 32 bit (Intel)] on win32 

3 Type "help", "copyright", "credits" or "license" for more information. 

4>>> dirí) 

EI. builtins ^", "' doc "y ^ Eile '"," name "', 'Tilling', 'notebook', "PD 'shell"| 
622» s-"this" 

7»»» s.capitalize() 

8'This' 

>>> s 

ae 'this' 

1l>>> n=23 

1222» pp(s) 


a >>> E 
= 
Namespace | Display | Calltip | History Dispatcher | 


'Shell.calltip' from <wx.py.shell.Shell; proxy of C++ wxStyledTextCtrl instance at  004bd501 p wxStyledTextCt 4 
'Interpreter.push' from <wx.py.interpreter.Interpreter instance at Ox01F00B48> 

'Shell.addHistory' from Anonymous 

'Interpreter.push' from <wx.py.interpreter.Interpreter instance at Ox01F00B48> 

'Shell.addHistory' from Anonymous 

'Shell.calltip' from <wx.py.shell.Shell; proxy of C++ wxStyledTextCtrl instance at  004bd501 p wxStyledTextCt 
'Interpreter.push' from <wx.py.interpreter.Interpreter instance at Ox01F00B48> 

'Shell.addHistory' from Anonymous 





'Interpreter.push' from <wx.py.interpreter.Interpreter instance at Ox01FO00B48> 

'Shell.addHistory' from Anonymous 

'Interpreter.push' from <wx.py.interpreter.Interpreter instance at Ox01F00B46> 

'Shell.addHistory' from Anonymous 

'Shell.calltip' from <wx.py.shell.Shell; proxy of C++ wxStyledTextCtrl instance at  004bd501 p wxStyledTextCt 
'Interpreter.push' from <wx.py.interpreter.Interpreter instance at O0x01F00B46> 

'Shell.addHistory' from Anonymous 








这 里 的 Dispatcher 标签 也 演示 了 如 何 增加 另 一 个 标签 到 一 个 wx.Notebook 4Z 
件 。 下 面 这 个 在 Dispatcher 标签 上 的 文本 控件 的 源码 ， 演 示 了 如 何 使 
用 dispatcher 模块 : 


class DispatcherListing(wx.TextCtrl): 
"""Text control containing all dispatches for session.""" 


def _ init (self, parent=None, id--1): 

style - (wx.TE MULTILINE | wx.TE READONLY | 

WX.TE RICH2 | wx.TE DONTWRAP) 

wx.TextCtrl. init__(self, parent, id, style-style) 
dispatcher.connect(receiver-self.spy) 


def spy(self, signal, sender): 
"""Receiver for Any signal from Any sender.""" 
text = '%r from %s' % (signal, sender) 
self.SetInsertionPointEnd() 
start, end - self.GetSelection() 
if start !- end: 
self.SetSelection(0, 0) 
self.AppendText(text + '\n') 


现在 我 们 已 经 看 到 了 PyCrust 作为 独立 的 Python shell 和 名 子 空间 检查 器 能 


法 。 


如 何 将 PyCrust 应 用 于 wxPython 应 用 程序 


让 我 们 假设 你 已 经 用 wxPython 创建 了 一 个 程序 ， 并 且 你 的 程序 正在 工作 ， 现 在 你 
想 更 好 地 了 解 它 是 如 何 工 作 的 。 在 这 章 的 前 面 你 已 经 看 到 了 Pycrust 的 特性 ， 它 
们 看 起 来 对 于 理解 你 的 程序 的 功能 是 非常 有 用 的 。 


通过 将 你 的 程序 的 名 字 传 递 给 Pywrap ， 你 能 够 用 PyCrust shell 来 启动 你 的 
程序 ， 不 需要 对 你 的 程序 作 任何 的 改变 。 下 例 4.2 显 示 了 一 个 名 为 spare.py 的 程 
序 ， 我 们 准备 对 它 使 用 PyCrust ° 


例 4.2 


#!/usr/bin/env python 
"""Spare.py is a starting point for simple wxPython programs.""" 
import wx 


class Frame(wx.Frame): 
pass 


class App(wx.App): 


def OnInit(self): 
self.frame = Frame(parent=None, id=-1, title='Spare') 
self .frame.Show( ) 
self .SetTopwindow(self.frame) 
return True 


aap (ali — == ie e s: 


app = App() 
app .MainLoop( ) 


为 了 运行 这 个 程序 时 使 用 PyCrust ， 要 将 该 程序 的 全 路 径 传 递 给 Pywrap ° 
在 Linux 上 ， 命 令 行 类 似 如 下 : 


$ pywrap Spare .py 


在 windows 下 ， 命 令 行 类 似 如 下 : 


F:\ python pywrap.py spare.py 


在 开始 的 时 候 ， Pywrap 试图 导入 命令 行 所 包括 的 模块 。 然 后 Pywrap 在 模块 中 
寻找 wx.App 的 子 类 ， 并 创建 子 类 的 一 个 实例 。 之 后 Pywrap 创建 一 个 带 

有 shell 的 wx.py.crust.CrustFrame 窗口 ， 把 这 个 应 用 程序 对 象 显示 

在 Pycrust 的 名 字 空 间 树 中 ， 并 且 启 动 wxPython 事件 循环 。 


Pywrap 的 源码 显示 在 例子 4.3 中 。 它 显示 了 如 何 用 少量 的 代码 将 大 量 的 功能 增加 
到 你 的 程序 中 。 


例 4.3 


"""PyWwrap is a command line utility that runs a python 
program with additional runtime tools, such as PyCrust.""" 


. author  - "Patrick K. O'Brien pobrien@orbtech.com " 

. cvsid = "$Id: PyCrust.txt,v 1.15 2005/03/29 23:39:27 robind 
Exp pu 

__revision__ = "$Revision: 1.15 $"[11:-2] 


import os 
import sys 
import wx 
from wx.py.crust import CrustFrame 


def wrap(app): 
wx.InitAllImageHandlers() 
frame = CrustFrame() 
frame.SetSize((750, 525)) 
frame.Show(True) 
frame.shell.interp.locals['app'] = app 
app.MainLoop() 


def main(modulename=None): 
sys.path.insert(0, os.curdir) 
if not modulename: 
if len(sys.argv) 2: 
print "Please specify a module name." 
raise SystemExit 
modulename = sys.argv[1] 
if modulename.endswith('.py'): 
modulename = modulename[:-3] 


module = __import__(modulename ) 
# Find the App class. 
App = None 


d = module. dict _ 
for item in d.keys(): 
try: 
if issubclass(d[item], wx.App): 
App - d[item] 
except (NameError, TypeError): 
pass 
if App is None: 
print "No App class was found." 
raise SystemExit 
app = App() 
wrap(app) 
if name == ' main _ 
main() 


PyWwrap 命令 之 后 ， 来 自 spare 的 简单 的 框架 ( frame) 和 PyCrust 的 框 


IP YWVUUSTIR17AF WXF VEDOn & 


PyCrust in action 


现在 让 我 们 看 看 ， 在 PyCrust shell 中 我 们 对 spare.py 应 用 程序 框架 做 些 什 
么 。 图 4.10 显 示 了 这 个 结果 。 我 们 将 通过 导入 wx 和 增加 一 个 画板 到 我 们 的 框架 作 
为 开始 : 


import wx 
app.frame.panel = wx.Panel(parent=app. frame) 
app.frame.panel.SetBackgroundColour( "White') 





True 
& 4.10 
Primary 
Left Center Ri ght AL 












=15) x| 


—Pytrust = 


File Edit View Options Help 





"eredits" or "license" for 
more information. 

>>> import wx 

>>> app.frame.panel-wvwx.Panel 
(parent=app. frame) 

>>> app.frame.panel. 
SetBackgroundColour('White') 
True 

>>> app: frame:panel. Petreski) ae 


一 “= 一 om 一 各 一 如 no 一 im 一 om 一 一 


Namespace | Display | Calltip | History | 1 
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增加 到 框架 的 画板 开始 时 是 默认 的 银灰 色 ， 然 后 它 被 改变 到 白色 。 然 而 ， 设 置 画板 


背景 色 不 立即 改变 它 的 显示 。 这 需要 去 触发 一 个 事件 来 导致 画板 重 绘 ， 以 使 用 它 的 
新 磊 色 属性 。 一 个 触发 这 样 事件 的 方法 是 要 求 画板 刷新 自身 : 


app.frame.panel.Refresh() 


现在 一 个 白色 的 画板 显示 了 ， 我 们 对 于 理解 wxPython 如 何 工作 的 细节 又 进 了 一 
步 。 


接 下 来 ， 让 我 们 增加 一 个 状态 栏 : 


NO 


app.frame.statusbar = app.frame.CreateStatusBar (number=3) 
app.frame.statusbar.SetStatusText("Left", 0) 

app. frame.statusbar.SetStatusText("Center", 1) 

app. frame.statusbar.SetStatusText("Right", 2) 


注意 在 不 改变 这 个 框架 的 尺寸 情况 下 ， 这 个 状态 栏 在 这 个 框架 中 是 如 何 显示 的 。 也 
要 注意 添加 到 三 个 状态 栏 中 的 文本 的 立即 显示 了 出 来 ， 而 不 要 求 刷新 。 现 在 让 我 们 
增加 一 个 菜单 和 一 个 菜单 栏 : 


app.frame.menubar = wx.MenuBar() 
menu = wx.Menu() 
app. frame.menubar.Append(menu, "Primary" ) 


app. frame.SetMenuBar (app. frame.menubar ) 
menu.Append(wx.NewId(), "One", "First menu item") 


menu.Append(wx.NewId(), "Two", "Second menu item") 


你 在 PyCrust shell 中 处 理 你 自己 的 wxPython 对 象 时 ， 注 意 改变 对 你 正在 
ernie Myon RDS ele as 中 菜单 何 时 才 实 际 显示 出 来 的 ? 
在 程 序 运行 的 时 候 ， 你 能 改变 Lal 性 ?你 能 够 让 它们 无 效 吗 交互 地 探究 

这 些 可 以 帮助 你 更 好 的 理解 wxPython ， 同 时 当 你 写真 实 的 代码 时 给 你 带 来 更 大 的 
自信 。 


到 目前 ， 我 们 已 经 花 了 很 多 节 讨 论 Pycrust ， 我 们 下 面 准备 看 一 看 Py AHH 
的 东西 。 


在 Py 包 中 还 有 其 它 什么 ? 


所 有 Pycrust 中 的 程序 都 利用 了 Py 包 中 的 Python HX» X 
如 shell.py , crust.py , introspect.py 和 interpreter.py ° 这些 程序 是 
用 来 做 PyCrust 的 建造 块 ， 你 可 以 分 别 或 一 起 使 用 它们 。 


PyCrust 代表 了 组 装 包含 在 Py 包 中 功能 模块 的 一 各 方法 。 PyShell 是 另 一 方 
法 ， PyAlaMode 是 第 三 种 。 在 这 些 方法 中 ， 它 们 的 底层 代码 大 多 数 是 相同 的 ， 只 
cc dE. 。 因 此 ， 你 可 以 把 py 当做 一 个 模块 库 ， 你 可 以 随意 地 在 

你 的 程序 中 的 任何 地 方 组 装 ] 其 中 的 模块 ， 用 来 显示 一 个 wxPython shell ^ —4 
代码 辑 器 或 运 行 时 内 省 信息 。 


在 Py 包 中 ， 提 供给 用 户 界面 功能 的 模块 和 没有 这 和 模块 有 明显 的 区 别 。 这 个 

区 别 使 得 在 你 的 程序 中 很 容易 使 用 这 些 模 块 。 以 E BIR 2a Kan FA 

P GUI AL FR > ho PyCrust , PyShell , PyAlaMode fe PyAlaCarte 。 在 你 的 程 
序 中 ， 你 不 会 想 导 入 这 些 模块 。 下 节 说 明 终端 用 户 模块 。 


使 用 GUI 程序 工作 


下 表 4.3 说 明了 用 户 级 程序 。 


PyAlaCarte : 简单 的 源 代码 编辑 器 。 一 次 编辑 一 个 文件 。 PyAlaMode :多 

件 源 代码 编辑 器 。 每 个 文件 分 别 显示 在 一 个 notebook 标签 中 。 第 一 个 标签 包含 一 
个 PyCrust 分 隔 窗 口 。 PyCrust :合并 了 wxPython 

shell 和 notebook 标签，notebook 包含 一 个 名 字 空 间 树 查看 器 。 

PyFilling : 简单 的 名 字 空 间 树 查看 器 。 这 个 程序 自己 不 是 很 有 用 。 它 的 存在 只 
是 作为 如 何 使 用 底层 库 的 一 个 例子 。 PyShell : 简单 的 wxPython shell J 

面 ， 没 有 PyCrust 中 的 notebook 。 功 能 上 ， PyShell 中 的 wxPython 

shell 和 PyCrust 中 的 是 一 样 的 。 Pywrap : 命令 行 工具 ， 用 以 运行 一 个 存在 
的 程序 和 PyCrust 框架 ， 让 你 能 够 在 PyCrust shell 中 处 理 这 个 应 用 程序 。 


使 用 支持 模块 工作 


支持 模块 为 终端 用 户 提供 了 基本 的 功能 ， 可 以 被 导入 你 的 程序 中 。 这 些 模块 是 用 来 
创建 用 户 级 Py 程序 的 建 


造 块 。 下 表 4.4 列 出 了 这 些 支持 模块 ， 它 们 是 Py 包 的 一 部 分 ， 说 明 如 下 : 


buffer : 支持 文件 编辑 。 crust : 包含 PyCrust 应 用 程序 独 有 的 GUI 元 
素 。 dispatcher : 提供 全 局 信号 分 派 服务 。 document : document 模块 包 
含 一 个 非常 简单 的 Document 类 ， 这 个 类 是 一 个 小 的 文件 类 。 document 跟踪 不 
同 的 文件 属性 ， 如 名 字 和 路 径 ， 并 提供 read() 和 write() 方法 。 Buffer 类 委 
托 这 些 低 级 的 读 写 操作 给 一 个 Document 实例 。 editor : 包含 所 有 显示 

在 PyAlaCarte 和 PyAlaMode 程序 中 的 GUI 编辑 部 分 。 editwindow :这 
个 editwindow 模块 包含 了 一 个 简单 的 Editwindow 类 。 这 个 类 继承 

自 wx.stc.StyledTextCtrl ( STC) ， 并 且 提 供 了 py 包 中 的 STC 的 三 种 主要 
用 法 的 所 有 共同 的 特性 ， 这 三 种 主要 用 法 是 : 作为 一 个 Python shell ,作为 一 
个 源 代码 编辑 器 和 作为 一 个 只 读 源 码 显 示 器 。 filling : 包含 所 有 的 GUI 控 
件 ， 这 些 GUI 控件 让 用 户 能 够 浏览 对 象 名 字 空 间 并 显示 那些 对 象 运行 时 的 信息 。 
frame : frame 模块 定义 了 一 个 Frame 类 ， 这 个 Frame 类 是 py 包 中 所 有 其 
它 frames 的 基 类 。 菜 单项 根据 当前 状态 和 上 下 文 不 断 地 自我 更 新 。 

images : images 模块 包含 被 不 同 Py 程序 使 用 的 图 标 。 

interpreter : Interpreter 类 负责 提供 自动 完成 列表 ， 调 用 提示 信息 等 。 
introspect : 为 一 些 方面 提供 多 种 内 省 类 型 ， 像 调用 提示 和 命令 自动 完成 。 
pseudo : 这 个 模块 定义 文件 类 类 ， 文 件 类 允许 Interpreter 类 去 重 定 

向 stdin , stdout , stderr ° shell : 这 个 模块 包含 GUI 元 素 ， 这 

些 GUI 元 素 定义 显示 在 PyCrust , PyShell 和 PyAlaMode 中 的 Python 
shell 的 界面 。 version : 这 个 模块 包含 一 个 名 为 VERSION HF HSE 
量 ， VERSION 代表 Py 当前 的 版 本 。 


下 面 我 们 讨论 更 复杂 的 模块 。 
buffer 模块 


buffer 模块 包含 一 个 Buffer 类 ， 这 个 类 支持 文件 的 通常 编辑 。 buffer 有 一 
些 方法 ， 例 如 new() , open() , hasChanged() , save() ,和 saveAs() ° X 
件 操作 基于 buffer 所 委托 的 Document 类 的 实例 ， Document 类 定义 

在 document 模块 中 。 文 件 内 容 的 实际 编辑 是 通过 Editor 类 的 一 个 或 多 个 实例 
发 生 的 ， Editor 类 定义 在 editor 模块 中 。 buffer 扮演 一 个 在 一 个 或 多 个 编 
辑 器 和 实际 物理 文件 之 间 的 中 间 人 。 


Buffer 类 的 一 个 独特 的 手法 是 每 个 buffer 实例 都 分 配 了 它 自己 的 Python fF 
释 器 实例 。 这 个 特点 使 得 buffer 能 够 被 用 在 那些 当 编 辑 Python 源 代 码 文件 时 
需要 提供 自动 完成 ， 调 用 提示 和 其 它 运行 时 帮助 的 应 用 程序 中 。 每 个 buffer AF 
释 器 都 是 完全 独立 的 ， 并 且 在 buffer 的 updateNamespace() 方法 被 调用 时 更 
新 。 下 例 4.4 显 示 了 updateNamespace() 方法 的 源 代 码 。 


例 4.4 


def updateNamespace( self): 
"""Update the namespace for autocompletion and calltips. 
Return True #if updated, False if there was an error.""" 


if not self.interp o not hasattr(self.editor, 'getText'): 
return False 
syspath - sys.path 
sys.path - self.syspath 


text - self.editor.getText() 

text = text.replace('\r\n', '\n') 
text = text.replace('Nr', '\n') 
name = self.modulename o self.name 


module = imp.new_module(name) 
newspace = module. (dict  .copy() 


try: 
try: 
code - compile(text, name, 'exec') 
except: 
raise 
try: 
exec code in newspace 
except: 
raise 
else: 
# No problems, so update the namespace. 
self.interp.locals.clear() 
self.interp.locals.update(newspace) 
return True 
finally: 


sys.path = syspath 

for m in sys.modules.keys(): 

if m not in self.modules: 
del sys.modules[m] 


这 个 方法 使 用 Python AM compile 方法 编译 编辑 器 中 的 文本 ， 然 后 使 用 关键 
词 exec 来 执行 。 如 果 编 译 成 功 ， 将 放置 若干 变量 到 newspace 名 字 空 间 中 。 通 
过 用 执行 的 结果 重 置 解释 器 的 局 部 名 字 空 间 ， 解 释 器 支持 访问 定义 在 编辑 器 

的 buffer 中 的 任何 类 ， 方 法 或 变量 。 


crust 模块 


crust 模块 包含 6 个 GUI 元 素 ， 它 们 专门 用 于 Pycrust 应 用 程序 的 。 这 最 常用 
的 类 是 CrustFrame ， 它 是 wx.Frame 的 子 类 。 如 果 你 再 看 一 下 例 4.3， 你 能 看 
到 Pywrap 程序 是 如 何 导 入 CrustFrame 并 创建 其 一 个 实例 的 。 这 是 谋 入 一 

个 PyCrust 框架 到 你 自己 的 程序 中 的 最 简单 的 方法 。 如 果 你 想 要 比 一 个 完整 的 框 
架 更 小 的 东西 ， 你 可 以 使 用 下 表 4.5 所 列 的 一 个 或 多 个 类 。 


表 4.5 


Crust :基于 wx.SplitterWwindow 并 包含 一 个 shell 和 带 有 运行 时 信息 

的 notebook ° Display : 样式 文本 控件 ， 使 用 Pretty Print 显示 一 个 对 
Ro Calltip :文本 控件 ， 包含 最 近 shell 调用 帮助 。 SessionListing 
文本 控件 ， 和 包含 关 于 一 个 会 话 的 所 有 命令 。 DispatcherListing :文本 控件 ， 
包含 关于 一 个 会 话 的 所 有 分 派 。 CrustFrame : 一 个 框架 ， 包 含 一 个 crust 分 
隔 窗口 。 


这 些 GUI 元 素 可 以 被 用 在 任何 wxPython 程序 中 ， 以 提供 有 用 的 可 视 化 内 省 。 
dispatcher 模块 


dispatcher 提供 了 全 局 信号 分 派 服务 。 那 意味 它 扮 演 着 一 个 中 间 人 ， 使 得 对 象 
能 够 发 送 和 接受 消息 ， 而 无须 知道 彼此 。 所 有 它们 需要 知道 的 是 这 个 正在 发 送 的 信 
号 (通常 是 一 个 简单 的 字符 囊 ) 。 一 个 或 多 个 对 象 可 以 要 求 这 个 dispatcher * 
当 信 号 已 发 出 时 去 通知 它们 ， 并 且 一 个 或 多 个 对 象 可 以 告诉 这 个 dispatcher X 
发 送 特殊 的 信号 。 


下 例 4.5 是 关于 为 什么 dispatcher 是 如 此 有 用 的 一 个 例子 。 因 为 所 有 的 Py 程序 
都 是 建造 在 相同 的 底层 模块 之 上 的 ， 所 以 pycrust 和 PyShell 使 用 几乎 相同 的 
代码 。 这 唯一 的 不 同 是 ， pyCrust 包括 了 一 个 带 有 额外 功能 的 notebook ， 如 名 
字 空 间 树 查看 器 ， 当 命令 被 发 送 到 解释 器 时 ， 名 字 空 间 树 查看 器 更 新 。 在 一 个 命令 
通过 解释 器 时 ， 解 释 器 使 用 dispatcher 发 送 一 个 信号 : 


例 4.5 经 由 dispatcher 模块 来 发 送 命令 的 代码 


def push(self, command): 
"""Send command 


to the interpreter to be executed. 


Because this may be called recursively, we append a new list 


onto the commandBuffer 
that. If the passed in 


list and then append commands into 
command is part of a multi-line 


command we keep appending the pieces to the last list in 


commandBuffer until we 


have a complete command. If not, we 


delete that last list.""" 


command = str(command) # In case the command is unicode. 
if not self.more: 


try: 
except IndexError: 


if not self.more: 


]) 


, sender=self, 


ce-source) 


del self.commandBuffer[-1] 

pass 

self.commandBuffer.append([]) 
self.commandBuffer[-1].append(command) 
source = 'Mn'.join(self.commandBuffer[-1 
more = self.more = self.runsource(source 
dispatcher .send(signal='Interpreter.push 


command=command, more=more, sour 


return more 


crust 中 的 各 有 关 部 分 和 filling 模块 在 它们 的 构造 器 中 通过 连接 
到 dispatcher ,自己 作为 信号 的 接受 器 。 下 例 4.6 显 示 了 关于 出 现 
在 PyCrust 的 Session 标签 中 的 SessionListing 控件 的 源码 : 


例 4.6 PyCrust session 标签 的 代码 


class SessionListing(wx.TextCtrl): 
"""Text control containing all commands for session.""" 


def _ init (self, parent=None, id--1): 
style = (wx.TE MULTILINE | wx.TE READONLY |wx.TE 
_RICH2 | wx.TE DONTWRAP) 


wx.TextCtrl. init (self, parent, id, style-sty 
le) 

dispatcher.connect(receiver-self.push,signal-'In 
terpreter.push') 


def push(self, command, more): 

"""Receiver for Interpreter.push signal.""" 

if command and not more: 
self.SetInsertionPointEnd() 
start, end - self.GetSelection() 

if start !- end: 
self.SetSelection(0, 0) 
self.AppendText(command + '\n') 


注意 SessionListing 的 接受 器 ( push() FH) 是 如 何 忽略 由 解释 器 发 送 来 
的 sender 和 source 参数 的 。 dispatcher 非常 灵活 ， 并 且 只 发 送 接受 器 能 接 


受 的 参数 。 
editor 模块 


editor 模块 包含 了 出 现在 PyAlaCarte 和 PyAlaMode 程 a GUI 编辑 
组 件 。 如 果 你 愿意 在 从 的 程序 中 包括 一 个 Python 源 代 码 编 辑 器 ， 那 么 使 用 在 下 表 
4.6 中 所 说 明 的 类 。 


这 些 类 可 以 被 使 用 在 任何 程序 EPF ARG 共有 用 的 代码 风格 编辑 功能 B 
R46 定义 在 editor 模块 中 的 类 


EditerFrame :被 PyAlaCarte 用 来 支持 一 次 一 个 文件 的 编 

辑 。 EditerFrame 是 来 自 frame 模块 的 较 一 般 的 Frame 类 的 子 类 。 
EditorNotebookFrame : EditerFrame 的 子 类 ， 它 通过 增加 一 

个 notebook 界面 和 同时 编辑 多 个 文件 的 能 力 扩 展 了 EditerFrame 。 它 是 一 个 
被 PyAlaMode 使 用 的 frame 类 。 EditorNotebook : 这 个 控件 

被 EditorNotebookFrame 用 来 在 各 自 的 标签 中 显示 各 自 的 文件 。 Editor : 管 
理 一 个 buffer 和 与 之 相关 的 Editwindow 之 间 的 关联 。 Editwindow : X 
于 styledTextctrl 的 文本 编辑 控件 。 


filling 模块 


filling 模块 包 含 所 有 使 用 户 能 够 浏览 对 象 的 名 字 空 间 和 显示 关于 那些 对 象 的 运 
行 时 信息 的 GUI 控件 。 定 义 在 filling 模块 中 的 四 个 类 的 说 明 见 下 表 4.7 


RAT 


FillingTree :基于 wx.Treectrl ， FillingTree 提供 对 象 名 字 空 间 的 分 级 
树 。 FillingText : editwindow.Editwindow 的 子 类 ， 用 以 显示 当前 

在 FillingTree 所 选择 的 对 象 的 细节 。 Filling :一 

个 wx.Splitterwindow ， 它 的 左边 包括 一 个 FillingTree ， 右 边 包 括 一 

个 FillingText ° FillingFrame :一 个 包含 Filling 分 隔 窗口 的 框架 。 双 

击 filling 树 中 的 一 项 将 打开 一 个 新 的 FillingFrame ， 其 中 被 选择 的 项 作为 树 
的 根 。 


使 用 这 些 类 ， 使 你 能 包 d ques Python 名 字 空 间 的 分 级 树 。 如 果 你 设置 你 的 数 
vA Python 对象 ， 这 能 够 用 作 一 个 快速 的 数据 浏览 器 。 


interpreter 模块 


interpreter 模块 定义 了 一 个 Interpreter X» AT pe 标准 库 中 

的 code 模块 的 Interactive - Interpreter 类 。 除 了 责 发 送 源 代码 

给 Python 外 ， Interpreter 类 还 负责 提供 , 调用 提示 信息 和 甚至 
触发 自动 完成 特性 的 关键 码 (通常 是 ".") 。 


由 于 这 清楚 的 责任 划分 ， 你 可 以 创建 你 自己 的 Interpreter 的 子 类 并 传递 其 一 个 
实例 到 Pycrust shell ， 从 而 代替 默认 的 interpreter 。 这 已 经 应 用 到 了 一 
些 程序 中 以 支持 自 定义 评议 种 类 ， 而 仍然 利用 PyCrust 环境 。 


introspect 模块 


introspect 模块 被 Interpreter 和 FillingTree 类 使 用 。 它 为 调用 提示 和 命 
令 自 动 完成 提供 了 多 种 内 省 类 型 支持 功能 。 下 面 显 示 了 wx.py.introspect 的 用 
法 ， 它 得 到 一 个 列表 对 象 的 所 有 属性 的 名 字 ， 排 除了 那些 以 双 下 划 线 开始 的 属性 : 


import wx 
= [1, 2, 3] 
wx. py.introspect.getAttributeNames(L, includeDouble-False) 
['append', 'count', 'extend', 'index', 'insert', 'pop', 
'remove', 'reverse', 'sort'] 


getAttributeNames() A?k FillingTree 类 使 用 以 生成 它 的 名 字 空 间 分 级 。 
理解 内 省 模块 的 最 好 方法 是 关注 单元 测试 。 查 看 你 的 Python 安装 目录 
的 Lib / site - packages / wx / py / tests 中 的 test introspect.py X 


fF o 
shell 模块 


shell 模块 包含 出 现在 PyCrust , PyShell ,和 PyAlaMode 定义 Python 
shell 界面 的 GUI 元 素 。 下 表 4.8 提 供 了 每 个 元 素 的 说 明 。 这 最 常用 的 类 
是 ShellFrame , 它 是 frame.Frame 的 子 类 。 它 包含 一 个 shell 类 的 实 

例 ， Shell 类 处 理 提供 交互 Python 环境 的 大 部 分 工作 。 


表 4.8 定义 在 shell 模块 中 的 类 


Shell : Python shell X f wx.stc.StyleTextCtrl ° Shell FH 

化 editwindow.Editwindow ， 然 后 使 底层 的 文本 控件 的 行为 像 一 具 Python 
shell ， 而 非 一 个 源码 文件 编辑 器 。 ShellFacade : 简化 的 与 所 有 shell M 
关 的 功能 的 接口 。 它 是 半 透 明 的 ， 它 仍然 是 可 访问 的 ， 尽 管 只 有 一 些 是 

对 shell 用 户 可 见 的 。 ShellFrame :一 个 包含 一 个 Shell 窗口 的 框架 。 


ShellFacade 类 在 PyCrust 的 开发 期 间 被 创建 ， 它 作为 在 shell 中 访 

问 shell 对 象 自身 时 去 简化 事情 的 一 个 方法 。 当 你 启 

动 PyCrust 或 PyShell 时 ， Shell 类 的 实例 在 Python shell 中 的 有 效 
的 。 例 如 ， 你 可 以 在 shell 提示 符 下 调用 shell 的 about() 方法 ， 如 下 所 示 : 


shell.about() 

Author: "Patrick K. O'Brien pobrien@orbtech.com " 
Py Version: 0.9.4 

Py Shell Revision: 1.7 

Py Interpreter Revision: 1.5 

Python Version: 2.3.3 

wxPython Version: 2.4.1.0p7 

Platform: linux2 


由 于 shell 继承 自 styledTextctrl ， 所 以 它 包 含 超过 600 个 属性 。 大 部 分 属性 
对 shell 提示 符 是 没 用 的 ， 因 此 ， ShellFacade 被 创建 来 限制 当 你 进 

入 shell 时 出 现在 自动 完成 列表 中 的 属性 的 数量 。 目 前 ， shell 对 象 只 显示 最 
有 用 的 shell 属性 的 25 个 。 


如 何在 wxPython 中 使 用 Py 包 中 的 模块 ? 


如 果 你 不 想 在 你 的 应 用 程序 使 用 一 个 完整 的 Pycrust 框架 ， 那 么 该 怎么 做 呢 ? 如 
果 你 在 一 个 框架 中 仅仅 只 想 要 shell 界面 ， 而 在 另 一 个 框架 中 要 一 个 名 字 空 间 查 
看 器 ， 该 怎么 办 呢 ? 如 果 你 想 把 它们 永久 添加 到 你 的 程序 中 以 该 怎么 办 呢 ? 这 些 方 
案 不 仅 是 可 能 的 ， 而 且 也 是 十 分 简单 的 。 我 们 将 用 一 个 例子 来 说 明 这 该 怎么 做 来 结 
束 本 章 。 

我 们 将 再 看 一 下 在 第 2 章 中 所 创建 的 程序 ， 它 带 有 一 个 菜单 栏 ， 工 具 栏 和 状态 栏 。 
我 们 将 添加 一 个 菜单 ， 它 的 一 个 菜单 项 用 以 显示 一 个 shell 框架 ， 另 一 个 用 来 显 
示 一 个 filling 框架 。 最 后 我 们 将 把 filling 树 的 根 设置 给 我 们 的 主 程序 的 框 
架 对 象 。 结 果 显 示 在 图 4.11 中 。 


图 4.11 


第 四 章 用 PyCrust 使 得 wxPython 更 易 处 理 


PyShell 


PyShell 0.9.5 - The Flakiest Python Shell 

Python 2.4.3 (#69, Mar 29 2006, 17:35:34) [MSC v.1310 32 

bit {Intel)] on win32 

Type "help", "copyright", "credits" or "license" for more 
information. 


locals(í) 


Type: «type 'dict'» 


Value: ('shell': «ux. 
py.shell.Shell; proxy 
of C++ 
wxStyledTextctrl 
instance at 
| 6085d501 p wxStyledTe | 














下 例 4.7 显 示 了 修改 过 的 源码 。 正 如 你 的 看 到 的 ， 我 们 只 增加 了 几 行 就 实现 了 所 要 求 
的 功能 。 


例 4.7 


#!/usr/bin/env python 


import wx 

H1 导入 这 些 框架 类 

from wx.py.shell import ShellFrame 
from wx.py.filling import FillingFrame 
import images 


class ToolbarFrame(wx.Frame): 


def _ init (self, parent, id): 
wx.Frame. (init (self, parent, id, 'Toolbars',s 
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ize=(300, 200)) 


panel = wx.Panel(self, -1) 
panel.SetBackgroundColour( 'White') 

statusBar - self.CreateStatusBar() 

toolbar - self.CreateToolBar() 
toolbar.AddSimpleTool(wx.NewId(), images.getNewB 


itmap()," New", "Long help for 'New'") 


项 


toolbar .Realize() 


menuBar = wx.MenuBar() 

menuí = wx.Menu() 

menuBar.Append(menui, " ") 

menu2 - wx.Menu() 

menu2.Append(wx.NewId(), " ^", "Copy in status b 


menu2.Append(wx.NewId(), "C ", "") 
menu2.Append(wx.NewId(), "Paste", "") 
menu2.AppendSeparator( ) 


menu2.Append(wx.NewId(), " ^", "Display Options" 
menuBar.Append(menu2, " ")#2 创建 Debug 菜 单 及 其 菜单 
menu3 = wx.Menu() 

shell = menu3.Append(-1, " shell","Open wxPython 


shell frame") 


pace viewer 


def 


def 


ha 
ang 


def 


def 


if | name | 


app 


app. 
app. 


filling = menu3.Append(-1, " viewer", "Open names 
frame") 

menuBar.Append(menu3, " ")#3 设置 菜单 的 事件 处 理 器 

self.Bind(wx.EVT MENU, self.OnShell, shell) 

self.Bind(wx.EVT MENU, self.OnFilling, filling) 


self.SetMenuBar(menuBar) 


OnCloseMe(self, event): 
self.Close(True) 


OnClosewindow(self, event): 
self.Destroy() #4 OnShe11 菜 单项 和 OnFiI1L1ing 菜 单项 处 


OnShell(self, event): 
frame = ShellFrame(parent-self) 
frame. Show( ) 


OnFilling(self, event): 
frame = FillingFrame(parent-self) 
frame. Show( ) 
== ' main ': 
= wx.PySimpleApp() 
frame = ToolbarFrame(parent=None, id--1) 
frame. Show( ) 


app .MainLoop( ) 


说 明 : 


#1 这 里 我 们 导入 了 ShellFrame 和 FillingFrame AX #2 我 们 添加 了 第 三 个 菜 

单 Debug 到 框架 的 菜单 栏 H3 绑 定 一 个 函数 给 wx.EVT MENU() ， 使 我 们 能 够 将 
一 个 处 理 器 与 菜单 项 关联 ， 以 便当 这 个 菜单 项 被 选择 时 调用 所 关联 的 处 理 器 。##4 
当 用 户 从 Debug 菜单 中 选择 Python shell 时 ， shell 框架 被 创建 ， 它 的 双 
亲 是 工具 栏 框 架 。 当 工具 栏 框架 被 关闭 时 ， 任 何 打 开 的 shell 或 filling 框架 
也 被 关闭 。 


本 草 小 结 


1、 像 wxPython 这 样 的 工具 包 本 身 是 大 而 复杂 的 。 cur 控件 之 间 的 交互 并 不 总 
是 直观 的 ， 整 个 的 处 理 决 定 于 事件 并 响应 于 事件 ， 而 非 一 个 线性 的 执行 序列 。 使 用 
如 PyCrust shell 能 够 很 大 程度 上 提高 你 对 事件 驱动 环境 的 理解 。 


2^ PyCrust 仅仅 是 另 一 个 Python shell ， 它 类 似 于 IDLE , Boa 
Constructor , Pythonwin 和 其 它 开发 工具 所 包括 的 shell 。 然 

而 ， PyCrust 是 用 wxPython 创建 的 ， 当 你 使 用 wxPython 开发 程序 时 ， 它 是 
很 有 用 的 。 尤 其 是 ， 你 不 会 有 任何 事件 循环 冲突 方面 的 问题 ， 并 且 你 可 以 

在 PyCrust 的 shell 和 名 字 空 间 查 看 器 中 处 理 你 的 程序 运行 时 的 所 有 方面 。 


3^ df PyCrust 是 wxPython 发 行 版 的 一 部 分 ， 所 以 它 随 同 wxPython 一 同 被 
安装 ， 包 括 了 所 有 的 源码 。 这 使 得 PyCrust 容易 使 用 ， 并 且 减 少 了 摸 清 如 何在 你 
自己 的 程序 中 提供 内 省 功能 的 学 习 曲 线 。 


4、 另 外 ， Py 包 的 模块 化 的 设计 ， 使 你 很 容易 去 挑选 最 有 益 于 你 程序 的 模块 ， 如 
源 代码 编辑 、 名 字 空 间 查 看 、 或 shell 

5、 PyCrust 减少 了 wxPython 学 习 的 曲线 ， 并 帮助 你 掌握 你 的 程序 运行 时 的 细 
微 之 处 。 


下 一 章 ， 我 们 将 应 用 我 们 所 学 到 的 关于 wxPython 方面 的 知识 ， 并 且 提 供 一 些 关 于 
如 何 组 织 你 的 GUI 程序 的 实用 的 建议 。 


第 五 草 绘制 蓝图 


1. 创建 你 的 蓝图 
i， 重 构 如 何 帮 我 改进 我 的 代码 ? 
ij， 一 个 重 构 的 例子 
ji， 开始 重 构 
ii, 进一步 重 构 
让 如何 保持 模型 (Model) 与 视图 (View) 分 离 ? 
i MVC(Model-View-Controller) 系 统 是 什么 ? 
i. 一 个 wxPython 模 型 : PyGridTableBase 
ii， 自 定义 模型 
诈 ， 如 何 对 一 个 GUI 程序 进行 单元 测试 ? 
i. unittest 2X 
ii, 一 个 unittest 范 例 
证 ， 测 试用 户 事件 
iv. 本 章 小 结 
众所周知 ， GUI 代码 是 难于 阅读 和 维护 的 ， 并 且 看 上 去 总 是 一 塌 糊 涂 。 本 章 我 们 
将 讨论 三 个 驯服 你 的 UI 代码 的 技术 。 我 们 将 讨论 重 构 代 码 以 使 其 易于 阅读 、 管 理 
和 维护 。 另 一 个 方面 是 显示 代码 和 基本 的 处 理 对 象 之 间 的 处 理 ， 这 也 是 UI 程序 员 
头痛 的 地 方 。 MVC ( Model / View / Controller ) 设计 模式 是 这 样 一 种 结 
构 ， 它 保持 显示 和 数据 分 离 以 便 各 自 的 改变 相互 不 影响 。 最 后 ， 我 们 讨论 对 你 
的 wxPython 代码 进行 单元 测试 的 技术 。 尽 管 本 章 的 所 有 例子 将 使 
用 wxPython ， 但 是 其 中 的 多 数 原 则 是 可 以 应 用 到 任何 ur 工具 的 ， 代 码 的 设计 
和 体系 结构 就 是 所 谓 的 蓝图 。 一 个 深思 熟 虑 的 蓝图 将 使 得 你 的 应 用 程序 建造 起 来 更 
简单 和 更 易 维 护 。 本 章 的 建议 将 帮助 你 为 你 的 程序 设计 一 个 可 靠 的 蓝图 。 


重 构 如 何 帮 我 改进 我 的 代码 ? 


好 的 程序 员 为 什么 也 会 写 出 不 好 的 界面 或 界面 代码 ? 这 有 很 多 原因 。 其 至 一 个 简单 
的 用 户 响 面 可 能 都 要 求 很 多 行 来 显示 屏幕 上 的 所 有 元 素 。 程 序 员 通常 试图 用 单一 的 
方法 来 实现 这 些 ， 这 种 方法 迅速 变 得 长 且 难 于 控制 。 此 外 界面 代码 是 很 容易 受到 不 
断 改变 的 影响 的 ， 除 非 你 对 管理 这 些 改变 训练 有 素 。 由 于 写 界 面 代码 可 能 是 很 枯燥 
的 ， 所 以 界面 程序 员 经 常会 使 用 设计 工具 来 生成 代码 。 机 器 生成 的 代码 相对 于 手工 
代码 来 说 是 很 差 。 


原则 上 讲 ， 保 持 UI 代码 在 控制 之 下 是 不 难 的 。 关 键 是 重 构 或 不 断 改进 现 有 代码 的 
设计 和 结构 。 重 构 的 目的 是 保持 代码 在 以 后 易 读 和 易于 维护 。 下 表 5.1 说 明了 在 重 构 
时 需要 记 住 的 一 些 原则 。 最 重要 的 是 要 记 住 ， 某 人 以 后 可 能 会 不 得 不 读 和 理解 你 的 
代码 。 努 力 让 他 人 的 生活 更 容易 些 ， 毕 竟 那 有 可 能 是 你 。 


表 5.1 重 构 的 一 些 重要 原则 


不 要 重复 : 你 应 该 避免 有 多 个 相同 功能 的 段 。 当 这 个 功能 需要 改变 时 ， 这 维护 起 来 
会 很 头痛 。 一 次 做 一 件 事情 : 一 个 方法 应 该 并 且 只 做 一 件 事情 。 各 自 的 事件 应 该 在 
各 自 的 方法 中 。 方 法 应 该 保持 短小 。 REN AREY : 尽量 使 钥 套 代码 不 多 于 2 或 3 
层 。 对 于 一 个 单独 的 方法 ， 深 的 肯 套 也 是 一 个 好 的 选择 。 避 免 字 面 意义 上 的 字符 串 
和 数字 : 字面 意义 上 的 字符 串 和 数字 应 使 其 出 现在 代码 中 的 次 数 最 小 化 。 一 个 好 的 
方法 是 ， 把 它们 从 你 的 代码 的 主要 部 分 中 分 离 出 来 ， 并 存储 于 一 个 列表 或 字典 中 。 


这 些 原则 在 Python 代码 中 特别 重要 。 因 为 Python 的 缩 进 语法 、 小 而 简洁 的 方 
法 是 很 容易 去 读 的 。 然 而 ， 长 的 方法 对 于 理解 来 说 是 更 困难 的 ， 尤 其 是 如 果 它 们 在 
一 个 屏幕 上 不 能 完全 显示 出 来 时 。 类 似 的 ， Python PARA RAI I RAI 
8 JE 36 fe 36 EAR ER » ZR ^ Python 在 避免 重复 方面 是 十 分 好 的 一 种 语言 ， 特 别 
是 因为 函数 和 方法 或 以 作为 参数 传递 。 


一 个 重 构 的 例子 


为 了 展示 给 你 如 何在 实际 工作 中 应 用 这 些 原则 ， 我 们 将 看 一 个 重 构 的 例子 。 图 5.1 显 
示 了 一 个 窗口 ， 它 可 用 作 访 问 微 软 Access 类 数据 库 的 前 端 。 


图 5.1 


Refactor Example 
File Edit 
FIRST 








First Name | 
Last Name | 


它 的 布置 比 之 前 我 们 的 所 见 过 的 那些 要 复杂 一 些 。 但 是 按 现实 中 的 应 用 程序 的 标 
准 ， 它 仍然 十 分 简单 。 例 5.1 的 代码 的 结构 很 差 。 


例 5.1 产生 图 5.1 的 没有 重 构 的 代码 


#!/usr/bin/env python 
import wx 
class RefactorExample(wx.Frame): 


def _init__(self, parent, id): 

wx.Frame. init (self, parent, id, 'Refactor Example',s 
ize-(340, 200)) 

panel - wx.Panel(self, -1) 
panel.SetBackgroundColour ("White") 
prevButton - wx.Button(panel, -1, " PREV", pos-(80, 0)) 
self.Bind(wx.EVT BUTTON, self.OnPrev, prevButton) 
nextButton = wx.Button(panel, -1, "NEXT ", pos=(160, 0)) 


G) 


); 


self.Bind(wx.EVT BUTTON, self.OnNext, nextButton) 
self.Bind(wx.EVT CLOSE, self.OnCloseWindow) 


menuBar - wx.MenuBar() 
menuí = wx.Menu() 
openMenuItem = menui.Append(-1, " ^", "Copy in status ba 


self.Bind(wx.EVT MENU, self.OnOpen, openMenuItem) 


quitMenuItem = menui.Append(-1, " ", "Quit") 
self.Bind(wx.EVT MENU, self.OnCloseWindow, quitMenuItem) 
menuBar.Append(menui, " ") 

menu2 - wx.Menu() 

copyItem = menu2.Append(-1, " ", "Copy") 


self.Bind(wx.EVT MENU, self.OnCopy, copyItem) 
cutItem - menu2.Append(-1, "C ", "Cut") 
self.Bind(wx.EVT MENU, self.OnCut, cutItem) 
pasteltem = menu2.Append(-1, "Paste", "Paste") 
self.Bind(wx.EVT MENU, self.OnPaste, pasteItem) 
menuBar.Append(menu2, " ") 
self.SetMenuBar(menuBar) 


static - wx.StaticText(panel, wx.NewId(), "First Name", 
pos-(10, 50)) 

static.SetBackgroundColour ("White") 

text = wx.TextCtrl(panel, wx.NewId(), "", size=(100, -1) 


pos-(80, 50)) 


static2 - wx.StaticText(panel, wx.NewId(), "Last Name", 
pos-(10, 80)) 

static2.SetBackgroundColour ("White") 

text2 = wx.TextCtrl(panel, wx.NewId(), "", size=(100, -1 


pos-(80, 80)) 


firstButton - wx.Button(panel, -1, "FIRST") 
self.Bind(wx.EVT BUTTON, self.OnFirst, firstButton) 


menu2.AppendSeparator( ) 
optItem = menu2.Append(-1, " ^", "Display Options") 
self.Bind(wx.EVT MENU, self.OnOptions, optItem) 


lastButton = wx.Button(panel, -1, "LAST", pos=(240, 0)) 
self.Bind(wx.EVT BUTTON, self.OnLast, lastButton) 


# Just grouping the empty event handlers together 


def 
def 
def 
def 
def 
def 
def 


OnPrev(self, event): pass 
OnNext(self, event): pass 
OnLast(self, event): pass 
OnFirst(self, event): pass 
OnOpen(self, event): pass 
OnCopy(self, event): pass 
OnCut(self, event): pass 


def OnPaste(self, event): pass 
def OnOptions(self, event): pass 


def OnCloseWindow(self, event): 
self .Destroy() 


if _name__ == ' main ': 
app = wx.PySimpleApp( ) 
frame = RefactorExample(parent=None, id--1) 
frame. Show( ) 
app .MainLoop( ) 


BEHAN > LORARGA-REMAT  RERARORA HEMAAM 
到 。 为 了 让 你 有 一 个 关于 如 何 调整 的 一 个 思想 ， 我 们 将 把 所 有 的 按钮 代码 分 别 放 到 
各 自 的 方法 中 。 下 表 5.2 归 纳 了 我 们 重 构 原 代码 应 解决 的 问题 

表 5.2 

原则 代码 要 重 构 的 地 方 

不 要 重复 几 个 模式 不 断 重复 ， 和 包括 "增加 按钮 ， 关 联 一 个 方法 ”， 

e “增加 菜单 项 并 关联 一 个 方法 "”，“ 创 建成 对 的 标签 /文本 条 目 ” 


一 次 只 做 一 件 事 代码 做 了 几 件 事情 。 除 了 基本 的 框架 ( frame) 设置 外 ， 它 创建 了 
菜单 栏 ， 增 加 了 按 


。 钮 ， 增 加 了 文本 域 。 更 糟糕 的 是 ， 功 能 在 代码 中 混在 一 起 。 
避免 避免 字面 意 义 上 的 字符 串 和 数字 在 构造 器 中 每 个 按钮 、 菜 单项 和 文本 框 都 有 一 
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个 文字 字符 串 和 坐标 常量 


开始 重 构 


例 5.2 中 只 包含 了 前 面 用 于 创建 按键 栏 的 代码 。 作 为 重 构 的 第 一 步 ， 我 们 在 例 5.2 中 
把 例 5.1 中 创建 按钮 栏 这 些 代码 抽出 来 放 在 了 它 自己 的 方法 中 : 


例 5.2 按钮 栏 作为 一 个 单独 的 方法 


def createButtonBar(self): 
firstButton = wx.Button(panel, -1, "FIRST" ) 
self.Bind(wx.EVT BUTTON, self.OnFirst, firstButton) 


prevButton = wx.Button(panel, -1, " PREV", pos=(80, 0)) 
self.Bind(wx.EVT BUTTON, , self.OnPrev, prevButton) 


nextButton - wx.Button(panel, -1, "NEXT ", pos-(160, 0)) 
self.Bind(wx.EVT BUTTON, self.OnNext, nextButton) 


lastButton = wx.Button(panel, -1, "LAST", pos=(240, 0)) 
self.Bind(wx.EVT BUTTON, self.OnLast, lastButton) 


向 上 面 这 样 把 代码 分 网 ， 所 有 按钮 添加 代码 之 间 的 共性 就 很 容易 看 出 来 了 。 我 
们 可 以 把 添加 按钮 的 ue E 成 一 个 公用 的 方法 来 调用 ， 而 避免 了 重复 。 如 例 5.3 所 
m 


15.3 一 个 公用 的 改进 了 的 按钮 栏 方法 
def createButtonBar(self, panel): 


self.buildOneButton(panel, "First", self.OnFirst) 
self.buildOneButton(panel, " PREV", self.OnPrev, (80, 0) 


) 

self.buildOneButton(panel, "NEXT ", self.OnNext, (160, 0 
)) 

self.buildOneButton(panel, "Last", self.OnLast, (240, 0) 
) 


def buildOneButton(self, parent, label, handler, pos=(0,0)): 
button = wx.Button(parent, -1, label, pos) 
self.Bind(wx.EVT BUTTON, handler, button) 
return button 


例 5.3 代 替 例 5.2 有 两 个 好 处 。 第 一 ， 简 短 的 方法 和 有 意义 的 方法 名 使 得 代码 的 可 读 
性 更 清晰 了 。 第 二 ， 它 避免 了 局 部 变量 (诚然 ， 你 也 可 以 通过 使 用 ID 来 避免 使 用 
局 部 变量 ， 但 那 容 易 导 致 重复 的 ID MM) 。 不 使 用 局 部 变量 是 有 好 处 的 ， 它 减少 
了 代码 的 复杂 程序 ， 并 且 也 因为 这 样 几乎 排除 ee Ades 

了 改变 所 有 变量 的 名 字 带 来 的 错误 。 (在 实际 的 应 用 中 ， 你 可 能 需要 存储 按钮 为 实 
例 变量 以 备 后 来 访问 ， 但 是 本 例 不 需要 。) 另外 ， buildoneButton() FARI 
放 进 一 个 工具 模块 中 并 可 以 在 别 的 框架 或 项 目 中 重用 。 


步 重 构 


上 面 的 例子 ， 已 经 得 到 了 很 多 的 改善 。 但 是 在 多 处 仍 有 许多 常量 。 其 一 ， 就 是 用 于 
定位 的 点 坐标 ， 当 另 一 个 按钮 被 添加 到 按钮 栏 时 可 能 使 代码 产生 错误 ， 尤 其 是 新 的 
EIRE Fe HUE P A 。 因 此 让 我 们 再 往 前 进一步 ， 我 们 把 这 些 字面 意义 上 的 
数据 从 处 理 中 分 离 出 来 。 下 例 5.4 展 示 了 一 个 用 于 创建 按钮 的 数据 驱 动机 制 。 


例 5.4 使 用 分 离 自 代码 的 数据 创建 按 锂 


def buttonData(self): 
return (("First", self.OnFirst), 
(" PREV", self.OnPrev), 
("NEXT ", self.OnNext), 
("Last", self.OnLast) ) 


def createButtonBar(self, panel, yPos=0): 
xPos = 0 
for eachLabel, eachHandler in self.buttonData(): 
pos = (xPos, yPos) 
button = self.buildOneButton(panel, eachLabel, e 
achHandler, pos) 
xPos += button.GetSize().width 


def buildOneButton(self, parent, label, handler, pos=(0,0)): 
button = wx.Button(parent, -1, label, pos) 
self.Bind(wx.EVT BUTTON, handler, button) 
return button 


4E 15.4 > APR d 42 085 CAE dE RE TRAE buttonData() 方法 的 元 组 中 。 
所 选 的 数据 结构 及 常量 方 法 的 使 用 不 是 必然 的 。 数 据 也 可 以 被 存储 在 一 个 类 级 的 变 
量 或 模块 级 的 变量 中 ， 而 非 一 个 方法 的 结果 ， 或 存储 于 一 个 外 部 的 文件 中 。 使 用 方 
法 的 好 处 就 是 ， 如 果 你 的 按钮 数据 存储 在 另 一 个 地 方 而 不 是 方法 中 的 话 ， 只 需要 改 
变 这 个 方法 而 使 它 返 回 外 部 的 数据 。 


createButtonBar() 方法 遍历 buttonData() 返回 的 列表 并 创建 相关 数据 的 按 
钮 。 这 个 方法 集 依次 根据 列表 自动 计算 按钮 的 x 坐标 。 这 是 很 有 帮助 的 ， 因 为 它 保 
证 了 代码 中 按钮 的 次 序 与 将 显示 在 屏幕 中 的 次 序 一 样 ， 使 得 代码 更 清晰 并 减少 出 错 
的 机 会 。 如 果 你 需要 将 一 个 按钮 添加 到 按钮 栏 的 中 间 的 话 ， 你 只 需 把 数据 添 加 到 这 
个 列表 的 中 间 ， 这 个 代码 确保 了 所 加 按钮 被 放置 在 中 间 。 


数据 的 分 离 有 其 它 的 好 处 。 在 一 个 更 精心 制作 的 例子 中 ， 数 据 可 以 被 存储 到 一 个 外 
部 的 资源 或 XML 文件 中 。 这 使 得 在 改变 界面 的 时 候 不 用 去 关心 代码 ， 并 且 使 国际 
化 更 容易 ， 很 容易 改变 文本 。 移 除了 数据 以 后 ， createButtonBar 方法 现在 成 了 
一 个 公用 方法 了 ， 它 可 以 容易 地 在 其 它 框架 或 项 目 中 被 重用 。 在 经 过 整合 相同 的 过 
程 ， 并 从 菜单 和 文本 域 代码 中 分 离 出 数据 后 ， 所 得 的 结果 显示 在 如 下 例 5.5 中 。 


例 5.5 一 个 重 构 的 例子 


#!/usr/bin/env python 
import wx 
class RefactorExample(wx.Frame): 
def _ init (self, parent, id): 


wx.Frame.__init__(self, parent, id, 'Refactor Ex 
ample',size-(340, 200) ) 


panel = wx.Panel(self, -1) 

panel .SetBackgroundColour ("White") 
self.Bind(wx.EVT CLOSE, self.OnCloseWindow) 
self.createMenuBar() # 简 化 的 jnit 方 法 

self .createButtonBar (panel) 

self .createTextFields(panel) 


def menuData(self): # 菜 单数 据 
return (("&File", 
("&Open", "Open in status bar", self.OnO 


pen), 
("&Quit", "Quit", self.OnCloseWindow) ), 
("&Edit", 
("&Copy", "Copy", self.OnCopy), 
("C&ut", "Cut", self.OnCut), 
("&Paste", "Paste", self.OnPaste), 
Rue Meee RE 
("&Options", "DisplayOptions", self.OnOp 
tions))) 
# 创 建 菜单 


def createMenuBar (self): 

menuBar = wx.MenuBar() 

for eachMenuData in self.menuData(): 
menuLabel = eachMenuData[0] 
menuItems = eachMenuData[1:] 
menuBar.Append(self.createMenu(menuItems 

), menuLabel) 
self.SetMenuBar(menuBar) 


def createMenu(self, menuData): 
menu - wx.Menu() 
for eachLabel, eachStatus, eachHandler in menuDa 


ta: 
if not eachLabel: 
menu.AppendSeparator() 
continue 
menultem - menu.Append(-1, eachLabel, ea 
chStatus) 
self.Bind(wx.EVT MENU, eachHandler, menu 
Item) 


return menu 


def buttonData(self): # 按 钮 栏 数据 
return (("First", self.OnFirst), 
"<< PREV", self.OnPrev), 
("NEXT >>", self.OnNext), 
("Last", self.OnLast) ) 
# 创 建 按 锂 
def createButtonBar(self, panel, yPos = 0): 
xPos = 0 
for eachLabel, eachHandler in self.buttonData(): 
pos = (xPos, yPos) 
button = self.buildOneButton(panel, each 


Label,eachHandler, pos) 
xPos += button.GetSize().width 


def buildOneButton(self, parent, label, handler, pos=(0, 
9 
button - wx.Button(parent, -1, label, pos) 
self.Bind(wx.EVT BUTTON, handler, button) 
return button 


def textFieldData(self): # 文 本 数据 
return (("First Name", (10, 50)), 


("Last Name", (10, 80))) 
# 创 建文 本 


def createTextFields(self, panel): 
for eachLabel, eachPos in self.textFieldData(): 
self.createCaptionedText(panel, eachLabe 
1, eachPos) 


def createCaptionedText(self, panel, label, pos): 
static = wx.StaticText(panel, wx.NewId(), label, 
pos) 
static.SetBackgroundColour ("White") 
textPos = (pos[0] + 75, pos[1]) 
wx.TextCtrl(panel, wx.NewId(), "", size=(100, -1 
), pos-textPos) 


# 空 的 事件 处 理 器 放 在 一 

e OnPrev(self, event): pass 
def OnNext(self, event): pass 
def OnLast(self, event): pass 
def OnFirst(self, event): pass 
def OnOpen(self, event): pass 
def OnCopy(self, event): pass 
def OnCut(self, event): pass 
def OnPaste(self, event): pass 
def OnOptions(self, event): pass 
def OnCloseWindow(self, event): 
self.Destroy() 

if name == ' main ': 

app = wx.PySimpleApp() 

frame = RefactorExample(parent=None, id=-1) 

frame .Show() 

app .MainLoop( ) 


MAIS AK $1515.5 » ZUf RF 077] » ， 但 我 们 所 得 寻 到 的 却 是 很 多 一 一 代码 非常 的 清 
楚 且 减少 了 出 错 的 机 会 。 代 码 的 布置 与 数据 的 布置 在 逻辑 上 是 匹配 的 。 那 些 普通 的 
做 法 (它们 劣质 的 代码 结构 可 能 导致 错误 如 采用 大 量 的 复制 和 粘贴 来 创建 新 的 





Xp) 已 经 被 去 掉 。 多 数 函 数 现 在 可 以 很 容易 地 被 移 到 一 个 超 类 或 公用 模块 中 ， 以 
保存 代码 便于 以 后 继续 利用 。 另 外， 数据 的 分 离 使 得 把 这 个 布局 作为 不 同 数 据 的 模 
板 很 容易 ， 包 括 国际 化 的 数据 。 


重 构 虽 说 完成 了 ， 但 是 例 5.5 中 的 代码 仍然 忽略 了 一 些 重要 的 事情 : 实际 用 户 的 数 
据 。 你 的 应 用 程序 要 做 很 多 事 依赖 于 处 理 数据 响应 用 户 要 求 。 你 的 程序 的 结构 还 可 
以 向 着 灵活 性 和 稳定 性 方向 发 展 。 me 模式 对 于 管理 界面 和 数据 之 间 的 交互 是 公 
认 的 标准 。 


如 何 保持 模型 (Model) 与 视图 (View) 分 离 ? 


最 早 可 追溯 到 1970 年 代 后 期 和 Smalltalk -80 语 言 ， MVC 模式 大 概 是 最 早 明 确 指 
出 面向 对 象 设计 的 模式 。 它 是 最 流行 的 一 种 ， 被 几乎 所 有 GUI 工具 和 包 所 采 
Flo MVC 模式 是 结构 化 程序 的 标准 ， 和 包括 处 理 和 显示 信息 。 


MVC(Model-View-Controller) 系 统 是 什么 ? 


MVC 系统 有 三 个 子 系统 。 Model 包含 经 常 被 调用 的 业务 逻辑 或 由 你 的 系统 处 理 
的 所 有 数据 和 信息 。 View 包含 显示 数据 的 对 象 ，Controller 管理 与 用 户 的 交 
A. ( Controller 处 于 Model 和 view 中 间 ) 。 下 表 5.3 归 纳 了 这 些 组 分 。 


表 5.3 标准 MVC 体系 的 组 成 
组 分 


Model : 包含 业务 逻辑 ,包含 所 有 由 系统 处 理 的 数据 。 它 包括 一 个 针对 外 部 存储 
(如 一 个 数据 库 ) 的 接口 。 通 常 模型 ( model) 只 暴露 一 个 公共 的 API 给 其 它 的 组 
分 。 


View : 包含 显示 代码 。 这 个 窗口 部 件 实际 用 于 放置 用 户 在 视图 中 的 信息 。 
在 wxPython 中 ， 处 于 wx.Window 层级 中 的 所 有 的 东西 都 是 视图 ( view) FAR 


的 一 部 分 。 


Controller : 包含 交互 逻辑 。 该 代码 接受 用 户 事件 并 确保 它们 被 系统 处 理 。 
在 wxPython 中 ， 这 个 子 系统 由 wx.EvtHandler 层级 所 代表 。 


在 现代 的 UI LHP > view fe Controller 组 分 是 被 集成 在 一 起 的 。 这 是 因 
A Controller 组 分 自身 需要 被 显示 在 屏幕 上 ， 并 且 因 为 经 常 性 的 你 想 让 显示 数 
据 的 窗口 部 件 也 响应 用 户 事 件 。 在 wxPython 中 ， 这 种 关系 实际 上 已 经 被 放置 进去 
1 (所 有 的 wx.window 对 象 也 都 是 wx,EvtHandler 的 子 类 ) ， 这 意味 着 它们 同 
时 具有 view AF Controller 元 素 的 功能 。 相 比 之 下 ， 大 部 分 web 应 用 架构 
对 于 View 和 Controller 有 更 严格 的 分 离 ， 因 为 其 交互 逻辑 发 生 在 服务 器 的 后 


ee 


图 5.2 中 显示 了 数据 和 信息 是 如 何在 MVC 体系 中 传递 的 。 
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Figure 5.2 The data flow of an MVC request 


一 个 事件 通知 被 Controller 系统 处 理 ( 它 把 事件 通知 放 到 一 个 合适 的 地 方 ) e 
如 我 们 在 第 三 章 中 所 看 到 的 ， wxPython 使 用 wx.EvtHandler 的 方 

法 ProcessEvent() 管理 这 个 机 制 。 在 一 个 严格 的 MVC PTE ALOE 
DES ES BOT $i Ho AH DR ER BM Be? 对 于 事件 的 响应 ， 这 
个 模型 ( model) 对 象 可 以 对 应 用 程序 数据 做 一 些 处 理 。 当 处 理 完成 时 ， 模 型 对 象 
发 送 一 个 更 新 通知 。 如 果 这 儿 有 一 个 控制 器 ( controller) 对 象 ， 那 么 该 通知 通常 
发 送 回 这 个 控制 器 ， 同 时 这 个 控制 器 对 象 通知 视图 ( view) 对 象 自我 更 新 。 在 一 个 
较 小 的 系统 或 一 个 较 简 单 的 体系 中 ， 通 知 通 常 直接 被 视图 对 象 所 接受 。 

在 wxPython 中 ， 来 自 于 模型 的 更 新 的 关键 在 于 你 。 你 的 选择 包括 从 模型 或 控制 器 
显 式 地 引发 自 定义 的 wxPython 事件 ， 使 模型 维护 的 对 象 的 列表 接受 更 新 通知 ， 或 
使 与 模型 关联 的 视图 接受 更 新 通知 。 


一 个 成 功 的 MVC 设计 的 关键 不 在 于 每 个 对 象 都 彼此 了 解 。 相 反 ， 一 个 成 功 

的 MVC 程序 ， 它 的 不 同 部 分 之 间 显 式 地 隐藏 了 一 些 东 西 。 其 目的 是 使 系统 最 低 限 
度 地 交互 ， 和 方法 之 间 的 明确 的 界定 。 尤 其 ， 这 个 Model 组 分 应 该 被 完全 

从 View 和 Controller 中 脱离 出 来 。 你 应 该 只 改变 那些 系统 而 不 改变 你 

的 Model 类 。 理 想 上 来 讲 ， 你 其 至 应 该 能 够 使 用 相同 Model 类 来 驱动 

JE wxPython 的 界面 ， 但 是 那 很 难 。 


从 View 方面 ， 你 应 该 能 够 在 Model 对 象 的 实现 中 做 改变 而 不 改 

"t View 或 Controller 。 而 View 依赖 于 某 些 公共 的 方法 的 存在 ， 它 不 应 该 看 
X, Model 内 私有 的 东西 。 无 可 否认 ， 这 在 Python 中 实施 是 有 困难 的 ， 但 有 一 个 
方法 可 以 帮助 我 们 ， 那 就 是 创建 一 个 抽象 的 Model 类 ， 它 定义 View 可 以 看 见 
的 API 。 Model 的 子 类 可 以 扮演 一 个 内 部 的 类 的 代理 而 被 改变 ， 或 可 以 简单 地 
自身 包含 内 部 的 工作 。 这 第 一 个 方案 更 结构 化 些 ， 第 二 个 更 容易 实现 。 


下 一 节 ， 我 们 将 看 一 看 内 建 于 wxPython 中 的 Model 类 中 的 一 

个 : wx.grid.PyGridTableBase 。 这 个 类 使 得 在 一 个 MVC 设计 架构 中 使 

用 grid 控件 成 为 可 能 。 这 之 后 ， 我 们 将 关注 一 下 对 于 一 个 定制 的 窗口 部 件 建造 和 
使 用 定制 的 模型 类 。 


一 个 wxPython 模 型 : PyGridTableBase 


类 wx.grid.Grid 是 一 个 电子 表格 式样 的 wxPython 控件 。 下 图 5.3 显 示 了 它 的 外 
XP o 























Figure 5.3 A sample of the 
wxPython grid control 


这 个 网 格 ( grid) 控件 有 很 多 有 趣 的 特点 ， 包 括 能 够 在 一 个 单元 一 个 单元 的 基础 上 
创建 自 定 义 的 泻 染 器 和 编辑 器 ， 以 及 可 拖 搜 的 行 和 列 。 这 些 特性 将 在 第 十 三 章 中 做 
更 详细 的 讨论 。 在 这 一 章 ， 我 们 将 针对 基础 和 展示 如 何 使 用 一 个 模型 去 卉 充 网 格 。 
例 5.6 显 示 在 一 个 网 格 中 设置 单元 值 的 简单 的 非 模型 方法 。 在 此 例 中 ， 网 格 中 的 值 是 
1984 年 艺 加 哥 小 态 队 的 阵容 。 


例 5.6 填充 网 格 (没有 使 用 模型 ) 


import wx 
import wx.grid 


class SimpleGrid(wx.grid.Grid): 
def — init (self, parent): 
wx.grid.Grid. init__(self, parent, 


self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 
self. 


CreateGrid(9, 2) 

SetColLabelValue(0, 
SetColLabelValue(1, 
SetRowLabelValue(0, 
SetCellValue(0, 0, 
SetCellValue(0, 1, 
SetRowLabelValue(1, 
SetCellValue(1, 0, 
SetCellValue(1, 1, 
SetRowLabelValue(2, 
SetCellValue(2, 0, 
SetCellValue(2, 1, 
SetRowLabelValue(3, 
SetCellValue(3, 0, 
SetCellValue(3, 1, 
SetRowLabelValue(4, 
SetCellValue(4, 0, 
SetCellValue(4, 1, 
SetRowLabelValue(5, 
SetCellValue(5, 0, 
SetCellValue(5, 1, 
SetRowLabelValue(6, 
SetCellValue(6, 0, 
SetCellValue(6, 1, 
SetRowLabelValue(7, 
SetCellValue(7, 0, 
SetCellValue(7, 1, 
SetRowLabelValue(8, 
SetCellValue(8, 0, 
SetCellValue(8, 1, 


class TestFrame(wx.Frame): 
def _ init (self, parent): 
wx.Frame. init (self, 


e=(275, 275)) 
grid 


if | name == 


| main __': 


- SimpleGrid(self) 


app - wx.PySimpleApp() 
frame = TestFrame(None) 
frame.Show(True) 
app.MainLoop() 
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在 例 5.6 中 ， 我 们 产生 了 SimpleGrid 类 ， 它 是 wxPython 类 wx.grid.Grid 的 
子 类 。 如 前 所 述 ， wx.grid.Grid 有 很 多 种 方法 ， 这 我 们 以 后 再 讨论 。 现 在 ， 我 
们 只 关心 方 

ik SetRowLabelValue() * SetColLabelValue() 和 SetCellvalue() ， 它 们 
实际 上 设置 显示 在 网 格 中 的 值 。 通 过 对 比 图 5.3 和 例 5.6 你 可 以 明 

É > SetCellvalue() 方法 要 求 一 个 行 索引 、 一 个 列 索 引 和 一 个 值 。 而 其 它 两 个 
方法 要 求 一 个 索引 和 一 个 值 。 


上 面 的 代码 使 用 了 set * 的 方法 直接 把 值 赋 给 了 网 格 。 然 而 如 果 对 于 一 个 较 大 的 网 
格 使 用 这 种 方法 ， 代 码 将 元 长 乏味 ， 并 很 容易 导致 错误 的 出 现 。 即 使 我 们 创建 公用 
程序 以 减轻 负担 ， 但 是 根据 重 构 的 原则 ， 代 码 仍 有 问题 。 数 据 与 显示 混在 一 起 ， 对 
于 将 来 代码 的 修改 是 困难 的 ， 如 增加 一 列 或 更 换 数 据 。 


解决 的 答案 就 是 wx.grid.PyGridTableBase 。 根 据 之 前 我 们 所 见 过 的 其 它 的 类 ， 
前 级 Py 表明 这 是 一 个 封装 了 C++ 类 的 特定 的 Python 类 。 就 像 我 们 在 第 三 章 中 所 
见 的 PyEvent 类 ， PyGridTableBase 的 实现 是 基于 简单 封装 一 个 wxWidgets 
C++ 类 ， 这 样 的 目的 是 使 得 能 够 继续 声明 该 类 ( Python 形式 的 类 ) 的 子 

类 。 PyGridTableBase 对 于 网 格 是 一 个 模型 类 。 也 就 是 说 ， 网 格 对 象 可 能 使 

用 PyGridTableBase 所 包含 的 方法 来 绘制 自身 ， 而 不 必 了 解 有 关 绘 制 数据 的 内 部 
结构 。 


PyGridTableBase 的 方法 


wx.grid.PyGridTableBase 有 一 些 方法 ， 它 们 中 的 许多 你 不 会 用 到 。 这 个 类 是 抽 
象 的 ， 并 且 不 能 被 直接 实 例 化 。 每 次 你 创建 一 个 PyGridTableBase 时 ， 有 五 个 必 
要 的 方法 必须 被 定义 。 表 5.4 说 明了 这 些 方法 。 


表 5.4 wx.grid.PyGridTableBase 的 必须 的 方法 
GetNumberRows() : 返回 一 个 表明 grid 中 行 数 的 整数 。 
GetNumberCols() : 返回 一 个 表明 grid 中 列 数 的 整数 。 


IsEmptyCell(row , col) : 如 果 索 引 ( row, col) 所 表示 的 单元 是 空 的 话 ， 返 
= True ° 


GetValue(row , col) :返回 显示 在 单元 ( row , col) 中 的 值 。 


SetValue(row , col , value) : 设置 单元 ( row, col) 中 的 值 。 如 果 你 想 要 
只 读 模 式 ， 你 仍 必须 包含 这 个 方法 ， 但 是 你 可 以 在 该 函数 中 使 用 pass 。 


表 ( table) 通过 使 用 网 格 ( grid) 的 SetTable() 方法 被 附加 在 grid 上 。 在 属 
性 被 设置 后 ， grid 对 象 将 调用 表 的 方法 来 得 到 它 绘制 网 格 所 需要 的 信 
Ao grid 不 再 显 式 使 用 grid 的 方法 来 设置 值 。 


使 用 PyGridTableBase 


一 般 情 况 下 ， 有 两 种 使 用 PyGridTableBase 的 方法 。 你 可 以 显 式 地 使 你 的 模型 类 
是 PyGridTableBase 的 子 类 ， 或 你 可 以 创建 一 个 单独 的 pyGridTableBase 的 子 
类 ， 它 关联 你 的 实际 的 模型 类 。 当 你 的 数据 不 是 太 复 杂 的 时 候 ， 第 一 种 方案 较 简单 
并 且 直 观 。 第 二 种 方案 需要 对 模型 和 视图 做 很 好 的 分 离 ， 如 果 你 的 数据 复杂 的 话 ， 


这 第 二 种 方案 是 更 好 的 。 如 果 你 有 一 个 预先 存在 的 数据 类 ， 你 想 把 它 用 
于 wxPython ， 那 么 这 第 二 种 方案 也 是 更 好 的 ， 因 为 这 样 你 可 以 创建 一 个 表 而 不 用 
去 改变 已 有 的 代码 。 在 下 面 一 节 我 们 将 展示 包含 这 两 种 方案 的 一 个 例子 。 


使 用 PyGridTableBase : 特定 于 应 用 程序 (不 通用 ) 的 子 类 


我 们 的 第 一 个 例子 将 使 用 PyGridTableBase 的 一 个 特定 于 应 用 程序 的 子 类 作为 我 
们 的 模型 。 由 于 我 们 小 能 队 阵 容 的 相对 简单 些 ， 所 以 我 们 使 用 它 。 我 们 把 这 些 数据 
组 织 到 一 个 派生 自 PyGridTableBase 的 类 。 我 们 把 这 些 实际 的 数据 配置 在 一 个 二 
维 Python 列表 中 ， 并 且 配 置 另外 的 方法 来 从 列表 中 读 。 下 例 5.7 展 示 了 生 成 自 一 
个 模型 类 的 小 熊 队 的 阵容 。 


例 5.7 生成 自 PyGridTableBase 模型 的 一 个 表 


import wx 
import wx.grid 


class LineupTable(wx.grid.PyGridTableBase): 


data = (("CF", "Bob", "Dernier"), ("2B", "Ryne", "Sandbe 
Eon 
("LF", "Gary", "Matthews", ("1B", "Leon", "Durh 
am"), 
("RF", "Keith", "Moreland"), (SBi "Ron", "Cey" 
); 
poc "Jody", "Davis"), (ess "Larry", "Bowa"), 
(Pia ERICK ollie limi es) 
colLabels = ("Last", "First") 


def _ init (self): 
wx.grid.PyGridTableBase. init (self) 


def GetNumberRows( self): 
return len(self.data) 


def GetNumberCols(self): 
return len(self.data[0]) - 1 


def GetColLabelValue(self, col): 
return self.colLabels[col] 


def GetRowLabelValue(self, row): 
return self.data[row] [0] 


def IsEmptyCell(self, row, col): 
return False 


def GetValue(self, row, col): 
return self.data[row][col + 1] 


def SetValue(self, row, col, value): 


pass 


class SimpleGrid(wx.grid.Grid): 
def _ init (self, parent): 
wx.grid.Grid. init__(self, parent, -1) 
self.SetTable(LineupTable()) # 设 置 表 


class TestFrame(wx.Frame): 
def — init (self, parent): 
wx.Frame. init (self, parent, -1, "A Grid",siz 
e-(275, 275)) 
grid = SimpleGrid(self) 


if _name__ == ' main ': 
app - wx.PySimpleApp() 
frame - TestFrame(None) 
frame.Show(True) 
app.MainLoop() 


在 例 5.7 中 ， 我 们 已 经 定义 了 所 有 必须 的 PyGridTableBase 方法 ， 并 加 上 了 额外 
的 方法 GetColLabelValue() 和 GetRowLabelValue() 。 项 望 你 不 要 对 这 两 个 额 
外 的 方法 感到 论 异 ， 这 两 个 额外 的 方法 使 得 表 ( table) 能 够 分 别 指定 行 和 列 的 标 
签 。 在 重 构 一 节 中 ， 使 用 模型 类 的 作用 是 将 数据 与 显示 分 开 。 在 本 例 中 ， 我 们 已 经 
把 数据 移入 了 一 个 更 加 结构 化 的 格式 ， 它 能 够 容易 地 被 分 离 到 一 个 外 部 文件 或 资源 
中 (数据 库容 易 被 增加 到 这 里 ) © 


使 用 PyGridTableBase : 一 个 通用 的 例子 


实际 上 ， 上 面 的 例子 很 接近 一 个 通用 的 能 够 读 任何 二 维 Python 列表 的 表 了 。 下 列 
5.8 展 示 这 通用 的 模型 的 外 观 : 


例 5.8 一 个 关于 二 维 列表 的 通用 的 表 


import wx 
import wx.grid 


class GenericTable(wx.grid.PyGridTableBase): 


def _ init__(self, data, rowLabels=None, colLabels=None): 
wx.grid.PyGridTableBase. init (self) 
self.data - data 
self.rowLabels 
self.colLabels 


rowLabels 
colLabels 


def GetNumberRows( self): 
return len(self.data) 


def GetNumberCols(self): 
return len(self.data[0]) 


def GetColLabelValue(self, col): 
if self.colLabels: 
return self.colLabels[col] 


def GetRowLabelValue(self, row): 
if self.rowLabels: 
return self.rowLabels[row] 


def IsEmptyCell(self, row, col): 
return False 


def GetValue(self, row, col): 
return self.data[row][col] 


def SetValue(self, row, col, value): 
pass 


GenericTable 类 要 求 一 个 数据 的 二 维 列表 和 一 个 可 选 的 行 和 列 标 签 列 表 。 这 个 
类 适合 被 导入 任何 wxPython 程序 中 。 使 用 一 个 做 了 微小 改变 的 格式 ， 我 们 现在 
可 以 使 用 这 通用 的 表 来 显示 阵容 ， 如 下 例 5.9 所 示 : 


例 5.9 使 用 这 通用 的 表 来 显示 阵容 


import wx 
import wx.grid 
import generictable 


data = (("Bob", "Dernier"), ("Ryne", "Sandberg"), 
("Gary", "Matthews"), ("Leon", "Durham"), 
("Keith", "Moreland" ), ("Ron",. "Cey"), 
("Jody", "Davis"), ("Larry", "Bowa"), 
("Rick", "Sutcliffe")) 


colLabels 
rowLabels 


(East “First") 
("CF", "2B", Oijen "1B", "RF", "3B", Ne "ss", "p") 


class SimpleGrid(wx.grid.Grid): 
def _ init (self, parent): 
wx.grid.Grid. init (self, parent, -1) 
tableBase - generictable.GenericTable(data, rowLabels, 
colLabels) 
self.SetTable(tableBase) 


class TestFrame(wx.Frame): 
def _ init (self, parent): 
wx.Frame. init (self, parent, -1, "A Grid", 
size-(275, 275)) 
grid - SimpleGrid(self) 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = TestFrame(None) 
frame.Show(True) 
app.MainLoop() 


使 用 PyGridTableBase : 一 个 独立 的 模型 类 


至 于 避免 重复 性 ， 有 另 一 种 使 用 pyGridTableBase 的 方法 值得 在 这 展示 给 大 家 。 
这 就 是 我 们 早先 提 到 的 第 二 种 方案 ， 数 据 在 一 个 单独 的 模型 类 中 ， 通 

过 PyGridTableBase 来 访问 。 Python 的 自我 检查 功能 在 这 是 非 常 有 用 的 ， 使 
你 能 够 在 每 列 显示 一 个 属性 的 列表 ， 然 后 使 用 内 建 函 数 getattr() 去 获取 实际 的 
值 。 在 这 种 情况 下 ， 模 型 要 求 一 个 元 素 的 列表 。 在 wxPython 中 ， 使 用 单独 的 模 
型 对 象 结构 化 你 的 程序 有 一 个 大 的 优势 。 在 通常 的 情形 下 ， 对 于 一 个 grid ， 你 
只 能 调用 SetTable() 一 次 ， 如 果 你 想 去 改变 表 ， 你 需要 创建 一 个 新 的 grid ， 
那 是 烦人 的 。 然 而 ， 在 接 下 来 的 例子 中 ， 你 的 PyGridTableBase 仅 存 储 了 对 于 你 
的 实际 数据 类 的 实例 的 引用 ， 这 样 一 来 ， 以 后 你 就 只 需 通 过 改变 表 中 基本 的 数据 对 
象 ， 就 可 以 更 新 表 中 的 数据 为 新 的 数据 了 。 


下 例 5.10 展 示 使 用 了 关于 阵容 条 目的 单独 的 数据 类 的 PyGridTableBase 。 我 们 省 
去 了 框架 的 另 一 列表 和 数据 创建 ， 它 们 是 与 前 一 例子 十 分 类 似 的 。 


例 5.10 使 用 了 一 个 自 定义 的 数据 类 的 阵容 显示 表 


import wx 
import wx.grid 


class LineupEntry: 


def _init_ (self, pos, first, last): 
self.pos = pos 
self.first = first 
self.last = last 


class LineupTable(wx.grid.PyGridTableBase): 


colLabels = ("First", "Last") # 列 标签 
colAttrs = ("first", "last") #1 属性 名 


def ”init (self, entries): #2 初始 化 模型 


wx.grid.PyGridTableBase. init (self) 
self.entries - entries 


def GetNumberRows( self): 
return len(self.entries) 


def GetNumberCols(self): 
return 2 


def GetColLabelValue(self, col): 
return self.colLabels[col] # 读 列 标签 


def GetRowLabelValue(self, col): 
return self.entries[row].pos #3 读 行 标签 


def IsEmptyCell(self, row, col): 
return False 


def GetValue(self, row, col): 
entry = self.entries[row] 
return getattr(entry, self.colAttrs[col]) #4 读 属 性 值 


def SetValue(self, row, col, value): 
pass 


说 明 : 
#1: 这 个 列表 包含 了 一 些 属 性 ， 它 们 被 引用 去 按 列 地 显示 每 列 的 值 。 


#2 : 这 个 模型 要 求 一 个 条 目的 列表 ， 每 个 条 目 都 是 LineupEntry 的 一 个 实例 。 
(这 里 我 们 没有 做 任何 的 错误 检查 ) 。 


#3 : 要 得 到 行头 的 标签 ， 我 们 查看 条 目的 pos 属性 。 


#4 : 第 一 步 是 根据 行 来 得 到 正确 的 条 目 。 所 要 求 的 属性 来 自 于 #1 中 的 列表 ， 然 
后 getattr() 被 用 来 引用 实际 的 值 。 这 个 机 制 是 可 扩展 的 ， 即 使 是 在 你 不 知道 该 
名 字 是 否 引 用 一 个 属性 或 方法 的 情况 下 ， 你 也 可 以 通 过 检查 object 

attribute 来 看 是 否 其 可 调用 。 如 果 可 调用 ， 那 么 使 用 通常 的 Python HAE 
法 来 调用 它 ， 并 返回 它 的 值 。 


grid 类 是 wxPython 已 有 的 一 个 有 价值 的 模型 组 件 来 帮助 你 结构 化 你 的 应 用 程 
序 的 一 个 例子 。 下 一 节 我 们 将 讨论 如 何 为 别 的 wxPython 对 象 创建 模型 组 件 。 


自 定 义 模 型 


创建 你 的 模型 对 象 所 基于 的 基本 思想 是 简单 的 。 首 先 构 造 你 的 数据 类 而 不 要 担心 它 
们 将 如 何 被 显示 。 然 后 为 数据 类 作 一 个 公共 接口 ， 该 接口 对 显示 对 象 是 能 够 被 访问 
的 。 很 明显 ， 这 个 工程 的 大 小 和 复杂 性 将 决定 过 个 公共 声明 的 形式 如 何 。 在 一 个 小 
的 工程 中 ， 使 用 简单 的 对 象 ， 可 能 足够 做 简单 的 事件 和 使 视图 对 象 能 够 访问 该 模型 
的 属性 。 在 一 个 更 复杂 的 对 象 中 ， 对 于 这 种 使 用 你 可 能 想 定义 特殊 的 方法 ， 或 创建 
一 个 分 离 的 模型 类 ， 该 类 是 视图 唯一 看 到 的 东西 (正如 我 们 在 例 5.10 所 做 的 ) 。 


为 了 使 视图 由 于 模型 中 的 改变 而 被 得 到 通知 ， 你 也 需要 某 种 机 制 。 例 5.11 展 示 了 一 
个 简单 的 一 个 抽象 的 基 类 ， 你 可 以 用 它 作为 你 的 模型 类 的 双亲 。 你 可 以 把 这 看 
成 PyGridTableBase 用 于 当 显 示 不 是 一 个 网 格 ( grid) 时 的 一 个 类 似 情 况 。 


例 5.11 用 于 更 新 视图 的 一 个 自 定义 的 模型 





class AbstractModel(object): 


def _ init (self): 
self.listeners = [] 


def addListener(self, listenerFunc): 
self .listeners.append(listenerFunc) 


def removeListener(self, listenerFunc): 
self.listeners.remove(listenerFunc) 


def update(self): 
for eachFunc in self.listeners: 
eachFunc(self) 


我 们 这 里 的 listener 应 该 是 可 调用 的 对 象 ， 它 需要 self 作为 参数 

( eachFunc(self) ) 很 明显 ， self 的 实际 的 类 可 以 是 不 同 的 ， 因 此 你 
的 listenter 很 灵活 了 。 同 样 ， 我 们 已 经 将 AbstractModel 配置 成 一 个 
Python 的 新 型 的 类 ， 事 实 上 它 是 object 的 子 类 。 因 此 本 例 要 求 Python 的 版 
本 是 Python2.2 或 更 高 。 


我 们 如 何 使 用 这 个 抽象 的 类 呢 ? 图 5.4 显 示 了 一 个 新 的 窗口 ， 类 似 于 我 们 本 章 早 先 讲 


重 构 时 所 显示 的 窗口 。 这 个 窗口 简单 。 其 中 文本 框 是 只 读 的 。 斋 击 上 面 的 任 一 按 甸 
将 在 文本 框 中 显示 相应 的 字符 。 





显示 这 个 窗口 的 程序 使 用 了 一 个 简单 的 MVC 结构 。 按 钮 的 处 理 器 方法 引起 这 个 模 
型 中 的 变化 ， 模 型 中 的 更 新 导致 文本 域 的 改变 。 例 5.12 展 示 了 这 个 细节 。 


115.12 


#!/usr/bin/env python 


import wx 
import abstractmodel 


class SimpleName(abstractmodel.AbstractModel): 


def — init (self, first="", last=""): 
abstractmodel.AbstractModel. init (self) 
self.set(first, last) 


def set(self, first, last): 
self.first - first 
self.last - last 
self.update() #1 更 新 


class ModelExample(wx.Frame): 


def _ init (self, parent, id): 

wx.Frame. init (self, parent, id, 'Flintstones', 
size-(340, 200)) 

panel - wx.Panel(self) 
panel.SetBackgroundColour ("White") 
self.Bind(wx.EVT CLOSE, self.OnCloseWindow) 
self.textFields - () 
self.createTextFields(panel) 


#2 创建 模型 
self.model = SimpleName( ) 
self .model.addListener (self .OnUpdate) 


self .createButtonBar (panel) 


def buttonData(self): 
return (("Fredify", self.OnFred), 
("Wilmafy", self.OnWilma), 
("Barnify", self.OnBarney), 
("Bettify", self.OnBetty) ) 


def createButtonBar(self, panel, yPos = 0): 
xPos = 0 
for eachLabel, eachHandler in self.buttonData(): 
pos = (xPos, yPos) 
button = self.buildOneButton(panel, eachLabel, eachH 
andler, pos) 


if name == 


xPos += button.GetSize().width 


def buildOneButton(self, parent, label, handler, pos=(0,0)): 
button = wx.Button(parent, -1, label, pos) 
self.Bind(wx.EVT BUTTON, handler, button) 
return button 


def textFieldData(self): 
return (("First Name", (10, 50)), 
("Last Name", (10, 80))) 


def createTextFields(self, panel): 
for eachLabel, eachPos in self.textFieldData(): 
self.createCaptionedText(panel, eachLabel, eachPos) 


def createCaptionedText(self, panel, label, pos): 
static - wx.StaticText(panel, wx.NewId(), label, pos) 
static.SetBackgroundColour ("White") 
textPos = (pos[0] + 75, pos[1]) 
self.textFields[label] - wx.TextCtrl(panel, wx.NewId(), 
"", Size-(100, -1), pos-textPos, 
style-wx.TE READONLY) 


def OnUpdate(self, model): #3 设置 文本 域 
self.textFields["First Name"].SetValue(model.first) 
self.textFields["Last Name"].SetValue(model.last) 


#4 响应 按钮 敲 击 的 处 理 器 
def OnFred(self, event): 
self.model.set("Fred", "Flintstone") 


def OnBarney(self, event): 
self.model.set("Barney", "Rubble") 


def OnWilma(self, event): 
self.model.set("Wilma", "Flintstone") 


def OnBetty(self, event): 
self.model.set("Betty", "Rubble") 


def OnCloseWindow(self, event): 
self.Destroy() 


_ main _': 
app = wx.PySimpleApp() 

frame = ModelExample(parent=None, id=-1) 
frame.Show() 

app .MainLoop( ) 


#2 : 这 两 行 创 建 这 个 模型 对 象 ， 并 且 把 onupdate() 方法 注册 为 一 
个 listener 。 现 在 当 更 新 被 调用 时 ， OnUpdate() 方法 将 被 调用 。 


#3 : OnUpdate() 方法 本 身 简 单 地 使 用 模型 更 新 后 的 值 来 设置 文本 域 中 的 值 。 该 
方法 的 代码 中 可 以 使 用 self.model 这 个 实例 来 代替 model (它们 是 同一 个 对 
象 ) 。 使 用 方法 作为 参数 ， 代 码 是 更 健壮 的 ， 在 这 种 情况 下 ， 同 样 的 代码 可 以 监听 
多 个 对 象 。 


#4 : 按钮 斋 击 的 处 理 器 改变 模型 对 象 的 值 ， 它 触发 更 新 。 


在 这 样 一 个 小 的 例子 中 ， 使 用 模型 更 新 机 制 似乎 有 点 大 才 小 用 了 。 为 什么 按钮 处 理 
器 不 能 直接 设置 文本 域 的 值 呢 。 然 而 ， 当 这 个 模型 类 存在 一 个 更 复杂 的 内 部 状况 和 
处 理 时 ， 这 个 模型 机 制 就 变 得 更 有 价值 了 。 例 如 ， 你 将 能 够 将 内 部 的 分 配 从 一 

个 Python 字典 改变 为 一 个 外 部 的 数据 库 ， 而 不 在 视图 中 做 任何 改变 。 假如 你 正 
在 处 理 一 个 已 有 的 类 ， 而 不 能 或 不 愿 对 其 做 改变 ， 那么 AbstractModel 可 以 用 作 
该 类 的 代理 ， 方 法 与 例 5.10 中 的 阵容 所 用 的 方法 大 致 相同 。 


另外 ， wxPython 包含 两 个 单独 的 类 似 MVC 更 新 机 制 的 实现 ， 它 们 上 比 我 们 这 里 说 
明 的 这 个 有 更 多 的 特性 。 第 一 个 是 模块 wx.lib.pubsub ， 它 在 结构 上 与 我 们 先前 
给 出 的 类 AbstractModel 十 分 相似 。 名 为 Publisher 的 模型 类 使 得 对 象 能 够 监 
听 仅 特定 类 型 的 消息 。 另 一 个 更 新 系统 是 wx.lib.evtmgr.eventManager ， 它 建 
立 在 pubsub 之 上 ， 并 且 有 一 些 额 外 的 特性 ， 包 括 一 个 更 精心 的 面向 对 象 的 设计 
和 事件 关联 的 连接 或 去 除 的 易 用 性 。 


如 何 对 一 个 GUI 程序 进行 单元 测试 ? 


好 的 重 构 和 MVC 设计 模式 的 一 个 主要 的 好 处 是 ， 它 使 得 使 用 “单元 测试 "来 验证 你 程 
序 的 性 能 更 容易 了 。 单 元 测试 是 对 你 的 程序 的 单个 的 特定 功能 的 测试 。 由 于 重 构 
和 MVC 设计 模式 两 者 的 使 用 ， 使 得 你 的 程序 被 分 成 了 小 的 块 ， 因 此 你 更 容易 针对 
你 程序 的 个 别 的 部 分 写 特 定 的 单元 测试 。 当 重 构 的 时 候 ， 结 合 使 用 单元 测试 是 特别 
有 用 的 ， 因 为 完整 的 单元 测试 使 得 在 你 移动 你 的 代码 后 ， 你 能 够 检验 你 是 否 引 入 了 
任何 错误 。 


接 下 来 的 难题 是 在 单元 测试 中 如 何 测 试 UI 代码 。 测 试 一 个 模型 是 相对 简单 的 ， 
为 模型 的 大 部 分 功能 不 依赖 于 用 户 的 输入 。 测 试 界面 本 身 的 功能 比较 困难 ， 因 为 界 
面 的 行为 依赖 于 用 户 的 行为 ， 而 用 户 的 行为 又 是 难以 封装 在 内 的 。 在 这 一 节 ， 我 们 
将 给 你 展示 如 何在 wxPython 中 使 用 单元 测试 。 尤 其 是 在 单元 测试 期 间 手 工 产生 事 
件 去 触发 行为 的 用 法 。 


unittest 32 


当 写 用 户 测试 的 时 候 ， 使 用 已 有 的 测试 引擎 来 节省 减少 重复 的 写 代码 的 运行 你 的 测 
试 是 有 帮助 的 。 自 2.1 版 以 来 ，Python 已 发 布 了 unittest 模块 。 unittest JE 
块 使 用 一 名 为 PyUnit 的 测试 框架 (A 

见 http: // pyunit.sourceforge.net /) 。 PyUnit 模块 

由 Test , TestCase , TestSuite 组 成 。 下 表 5.5 说 明了 这 三 个 组 成 。 
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Test : # PyUnit 引擎 调用 的 一 个 单独 的 方法 。 根 据 约 定 ， 一 个 测试 方法 的 名 
字 以 test 开头 。 测 试 方法 通常 执行 一 些 代 码 ， 然 后 执行 一 个 或 多 个 断定 语句 来 测 
试 结果 是 否 是 预期 的 。 


TestCase :一 个 类 ， 它 定义 了 一 个 或 多 个 单独 的 测试 ， 这 些 测试 共享 一 个 公共 的 
配置 。 这 个 类 定义 在 PyUnit 中 以 管理 一 组 这 样 的 测试 。 Testcase 在 测试 前 后 
对 每 个 测试 都 提供 了 公共 配置 支持 ， 确 保 每 个 测试 分 别 运行 。 TestCase 也 定义 了 
一 些 专门 的 断定 方法 ， 如 assertEqual 。 


Testsuite :为 了 同时 被 执行 而 组 合 在 一 起 的 一 个 或 多 个 test 方法 
或 TestCase 对 象 。 当 你 告诉 PyUnit 去 执行 测试 时 ， 你 传递 给 它 一 
个 TestSuite 对 象 去 执行 。 


单个 的 PyUnit 测试 可 能 有 三 种 结果 : success (MA), failure (AK) ， 
或 error (错误 ) ° success 表明 测试 完成 ， 所 有 的 断定 都 为 真 (通过 ) ， 并 
且 没 有 引发 错误 。 也 就 是 说 得 到 了 我 们 所 希望 的 结果 。 Failure 和 error 表明 
代码 存在 问题 。 failure 意味 着 你 的 断定 之 一 返回 false ， 表 明代 码 执 行 成 功 
了 ， 但 是 没有 做 你 预期 的 事 。 error 意味 着 测试 执行 到 某 处 ， 触 发 了 一 

个 Python 异常 ， 表 明 你 的 代码 没有 和 运行 成 功 。 在 单个 的 测试 

中 ， failure 或 error 一 出 现 ， 整 个 测试 就 终止 了 ， 即 使 在 代码 中 还 有 多 个 断 
定 要 测试 ， 然 后 测试 的 执行 将 移 到 到 下 一 个 单个 的 测试 。 


一 个 unittest 范 例 


下 例 5.13 展 示 了 一 个 使 用 unittest 模块 的 范例 ， 其 中 对 例 5.12 中 的 模型 例子 进行 
测试 。 


例 5.13 对 模型 例子 进行 单元 测试 的 一 个 范例 


import unittest 
import modelExample 
import wx 


class TestExample(unittest.TestCase): 41 声明 一 个 TestCase 


def setUp(self): #2 为 每 个 测试 所 做 的 配置 
self.app = wx.PySimpleApp() 
self.frame = modelExample.ModelExample(parent=None, id=- 
1) 


def tearDown(self): #3 测试 之 后 的 清除 工作 
self.frame.Destroy() 


def testModel(self): #4 声明 一 个 测试 (Test ) 
self.frame.OnBarney(None) 
self.assertEqual("Barney", self.frame.model.first, 
msg="First is wrong") #5 对 于 可 能 的 失败 的 断定 
self.assertEqual("Rubble", self.frame.model.last) 


def suite(): #6 创建 一 个 TestSuite 
suite = unittest.makeSuite(TestExample, 'test') 
return suite 


if _name__ == ' main ': 
unittest.main(defaultTest='suite') #7 开始 测试 


说 明 : 


声明 unittest.TestCase 的 一 个 子 类 。 为 了 最 好 的 使 每 个 测试 相互 独立 ， 测 
试 执行 器 为 每 个 测试 创建 该 类 的 一 个 实例 。 


#2 : setUp() 方法 在 每 个 测试 被 执行 前 被 调用 。 。 这 使 得 你 能 够 保证 每 个 对 你 的 应 
用 程序 的 测试 都 处 在 相同 的 状态 下 。 这 里 我 们 创建 了 一 个 用 于 测试 的 框架 
( frame) 的 实例 。 


#3 : tearDown() 方法 在 每 个 测试 执行 完 后 被 调用 。 gg] T 
作 ， 以 确保 从 一 个 测试 转 到 另 一 个 测试 时 系统 状态 保持 一 致 。 里 包括 重 置 全 
局 数据 ， 关 闭 数 据 库 连接 等 诸如 此 类 的 东 东 。 

了 Destroy() ， 以 强制 性 地 使 wxwidgets 退出 ， 并 且 为 下 一 个 测试 保持 系统 处 
在 一 个 良好 的 状态 。 


#4 : 测试 方法 通常 以 test 作为 前 级 ， pip peus 制 之 下 (看 #6) 。 测 试 
方法 不 要 参数 。 我 们 这 里 的 测试 方法 中 ， 通 过 调用 OnBarney 事件 处 理 器 方法 来 开 
始 测试 行为 。 


#5 : 这 行使 用 assertEqual() 方法 来 测试 模型 对 象 的 改变 是 否 正 

确 。 assertEqual() 要 两 个 参数 ， 如 果 这 两 个 参数 不 相等 ， 则 测试 失败 。 所 有 
的 PyUnit 断定 方法 都 有 一 个 可 选 的 参数 msg ， 如 果断 定 失败 则 显 

示 msg(msg 的 默认 值 几 乎 够 表达 意思 了 ) 


H6: 这 个 方法 通过 简单 有 效 的 机 制 创 建 一 组 测试 。 makeSuite() 方法 要 求 一 

个 Python 的 类 的 对 象 和 一 个 字符 串 前 级 作为 参数 ， 并 返回 一 组 测试 ( 包含 该 类 中 
所 有 前 级 为 参数 “前 缀 "的 方法 ) 。 还 有 其 它 的 机 制 ， 它 们 使 得 可 以 更 明确 设置 测试 
组 中 的 内 容 ， 但 是 makeSuite() 方法 通过 足够 了 。 我 们 这 里 写 的 suite() 方法 
是 一 个 样板 模板 ， 它 可 被 用 在 你 的 所 有 测试 模块 中 。 


#7 : 这 行 调用 了 PyUnit 的 基于 文本 的 执行 器 。 参 数 是 一 个 方法 的 名 字 (该 方法 
返回 一 测试 组 ) 。 然 后 suite 被 执行 ， 并 且 结 果 被 输出 到 控制 台 。 如 果 你 想 使 

用 GUI 测试 执行 器 ， 那 么 这 行 调用 应 使 用 unittest.TextTestRunner 的 方法 而 
非 unittest.main ° 


在 控制 台中 PyUnit 测试 的 结果 如 下 : 


Ran 1 test in 0.190s 


OK 


这 是 一 个 成 功 的 测试 。 第 一 行 的 "." 号 表明 测试 成 功 。 每 个 测试 都 得 到 一 个 字符 并 显 
示 在 这 行 。"." 表 明成 功 ，"F" 表 明 失 败 ，"E" 表 明 错 误 。 然 后 是 一 个 简单 的 列表 ， 其 
中 包含 测试 的 数量 、 总 的 测试 时 间 和 OK ， OK 表明 所 有 测试 通过 。 


对 于 一 个 失败 或 错误 的 测试 ， 你 将 得 到 一 堆 跟 踪 提 示 (显示 了 python 得 到 的 错误 
处 的 情况 ) o Fike * de RR AHS X 
为 self.assertEqual("Fife", self.frame.model.first) ， 我 们 将 得 到 如 下 


Traceback (most recent call last): 

File "C:\wxPyBook\book\i\Blueprint\testExample.py", line 18, in 
testModel 

self.assertEqual("Fife", self.frame.model.last) 

File "c:Npython23MlibNunittest.py", line 302, in failUnlessEqual 
raise self.failureException, \ 

AssertionError: 'Fife' !- 'Rubble' 


Ran 1 test in 0.070s 


FAILED (failures-1) 


"F" 表 明了 失败 ，“ testModel ”是 产生 失败 的 方法 名 ， 下 面 的 跟踪 显示 出 18 号 上 的 
断定 失败 ， 以 及 失败 的 原因 。 你 一 般 需 要 根据 这 些 去 找到 产生 失败 的 实际 位 置 。 


测试 用 户 事 件 


当然 ， 上 面 的 测试 还 不 完整 。 我 们 还 可 以 对 框架 中 的 TextField 在 模型 更 新 后 ， 
其 中 和 值 的 更 新 情况 进行 测试 。 这 个 测试 是 很 简单 的 。 另 一 个 你 可 能 想 要 做 的 测试 
是 ， 自 动 生 成 按钮 敲 击 事件 ， 以 及 确保 正确 的 处 理 器 被 调用 。 这 个 测试 有 点 难度 。 
下 例 5.14 展 示 了 一 个 例子 : 


例 5.14 生成 一 个 用 户 事 件 的 测试 
def testEvent(self): 


panel = self.frame.GetChildren()[0] 
for each in panel.GetChildren(): 


if each.GetLabel() == "Wilmafy": 
wilma = each 
break 


event = wx.CommandEvent(wx.wxEVT COMMAND BUTTON CLICKED, 
wilma.GetId()) 

wilma.GetEventHandler().ProcessEvent(event) 

self.assertEqual("Wilma", self.frame.model.first) 

self.assertEqual("Flintstone", self.frame.model.last) 


本 例 开 始 的 几 行 寻找 一 个 适当 的 按钮 (这 里 是 " wilmafy "按钮 ) 。 由 于 我 们 没有 
显 式 地 把 这 些 按钮 存储 到 变量 中 ， 所 以 我 们 就 需要 遍历 panel 的 孩子 列表 ， 直 到 
我 们 找到 正确 的 按钮 。 接 下 来 的 两 行 创建 用 以 被 按钮 发 送 的 wx.CommandEvent X 
件 ， 并 发 送出 去 。 参 数 wx .wxEVT_COMMAND_BUTTON_CLICKED 是 一 个 常量 ， 它 表 
示 一 个 事件 类 型 ， 是 个 整数 值 ， 它 被 绑 定 到 EVT_BUTTON SHB RAB (你 
能 够 在 wx.py 文件 中 发 现 这 个 整数 常量 ) 。 wilma.GetId() 的 作用 是 设置 产生 
该 事件 的 按钮 ID 。 至 此 ， 该 事件 已 具有 了 实际 wxPython 事件 的 所 有 相关 特 

性 。 然 后 我 们 调用 ProcessEvent() 来 将 该 事件 发 送 到 系统 中 。 如 果 代 码 按 照 计 
划 工 作 的 话 ， 那 么 模型 的 first 和 last 中 的 名 字 将 被 改变 为 Wilma ”和 
“Flintstone ”。 


通过 生成 事件 ， 你 能 够 从 头 到 尾 地 测试 你 的 系统 的 响应 性 。 理 论 上 ， 你 可 以 生成 一 
个 筷 标 按 下 和 释放 事件 以 确保 响应 按钮 敲 击 的 按钮 敲 击 事件 被 创建 。 但 是 实际 上 ， 
这 不 会 工作 ， 因 为 低级 的 wx.Events 没有 被 转化 为 本 地 系统 事件 并 发 送 到 本 地 窗 
口 部 件 。 然 而 ， 当 测试 自 定 义 的 窗口 部 件 时 ， 可 以 用 到 类 似 于 第 三 章 中 两 个 按钮 控 
件 的 处 理 。 此 类 单元 测试 ， 对 于 你 的 应 用 程序 的 响应 性 可 以 给 你 带 来 信心 。 


本 章 小 结 


、 众 所 周知 ， GUI 代码 看 起 来 很 乱 且 难于 维护 。 这 一 点 可 以 通过 一 点 努力 来 解 
决 ， 当 代码 以 后 要 变动 时 ， 我 们 所 付出 的 努力 是 值得 的 。 


2 、 重 构 是 对 现存 代码 的 改进 。 重 构 的 目的 有 : 避免 重复 、 去 掉 无 法 理解 的 字面 
值 、 创 建 短 的 方法 (只 做 一 件 事情 ) 。 为 了 这 些 目标 不 断 努力 将 使 你 的 代码 更 容易 
去 读 和 理解 。 另 外 ， 好 的 重 构 也 几乎 避免 了 某 类 错误 的 发 生 (Go ores SKM 


错误 ) 。 


3、 把 你 的 数据 从 代码 中 分 离 出 来 ， 使 得 数据 和 代码 更 易 协同 工作 。 管 理 这 种 分 离 
的 标准 机 制 是 MVC 机制 。 用 wxPython 的 术语 来 

说 ，V(View) 是 wx.Window 对 象 ， 它 显示 你 的 数 

据 ; C(Controller) X wx.EvtHandler 对 象 ， 它 分 派 事 件 ; M(Model) 是 你 自 
已 的 代码 ， 它 包含 被 显示 的 信息 。 


4、 或 许 MVC 结构 的 最 清晰 的 例子 是 wxPython 的 核心 类 中 

的 wx.grid.PyGridTableBase ， 它 被 用 于 表示 数据 以 在 一 个 wx.grid.Grid 控 
件 中 显示 。 表 中 的 数据 可 以 来 自 于 该 类 本 身 ， 或 该 类 可 以 引用 另 一 个 包含 相关 数据 
的 对 象 。 


5、 你 可 以 使 用 一 个 简单 的 机 制 来 创建 你 自己 的 MVC 设置 ， 以 便 在 模型 被 更 新 时 通 
知 视图 ( view) ° Æ wxPython 中 也 有 现成 的 模块 可 以 帮助 你 做 这 样 的 事情 。 


6、 单 元 测试 是 检查 你 的 程序 的 正确 性 的 一 个 好 的 方法 。 

在 Python 中 ， unittest 模块 是 执行 单元 测试 的 标准 方法 中 的 一 种 。 使 一 些 

包 ， 对 一 个 GUI 进行 单元 测试 有 点 困难 ， 但 是 wxPython 的 可 程序 化 的 创建 事件 
使 得 这 相对 容易 些 了 。 这 使 得 你 能 够 从 头 到 尾 地 去 测试 你 的 应 用 程序 的 事件 处 理 行 


在 下 一 章 中 ， 我 们 将 给 你 展示 如 何 去 建造 一 个 小 型 的 应 用 程序 以 及 如 何 去 做 一 些 事 
情 ， 这 些 对 你 将 建造 的 wxPython 应 用 程序 将 是 通用 的 。 


第 六 章 使 用 wxPython 基 本 构件 


1. 使 用 基本 的 建造 部 件 

i 在 屏幕 上 绘画 
i， 如 何在 屏幕 上 绘画 

ii， 添 加 窗口 装饰 
i， 如 何 添加 和 更 新 一 个 状态 栏 
ii， 如 何 添 加 菜单 ? 
iii， 如 何 添 加 一 个 工具 栏 

i 诈 ， 得 到 标准 信息 
ji， 如 何 使 用 标准 文件 对 话 框 ? 
ii 如何 使 用 标准 的 颜色 选择 器 ? 

iv， 给 应 用 程序 一 个 好 看 的 外 观 
i， 如 何 布局 窗口 部 件 ? 
ii, 如何 建 造 一 个 关于 (about) 框 ? 
i 诈 如何 建造 一 个 启动 画面 ? 

v. 本 章 小 结 


即使 是 一 个 简单 的 wxPython 程序 也 需要 使 用 标准 的 元 素 ， 诸 如 菜单 和 对 话 框 。 这 
儿 有 对 于 任 一 GUI 应 用 程序 的 基本 的 建造 部 件 。 使 用 这 些 建造 部 件 ， 还 有 像 局 动 
画面 、 状 态 栏 或 关于 框 等 这 些 窗口 部 件 ， 它 们 给 你 提供 了 一 个 更 友好 的 用 户 环境 ， 
并 且 给 了 你 的 应 用 程序 一 个 专业 的 感 观 。 为 了 要 结束 本 书 的 第 一 部 分 ， 我 们 将 指导 
你 通过 一 个 程序 的 创建 来 使 用 所 有 所 学 的 部 分 。 我 们 将 建造 一 个 简单 的 绘画 程序 ， 
然后 添加 这 些 建 造 部 件 元 素 并 说 明 使 用 它们 时 的 一 些 问题 。 我 们 将 巩固 前 面 章节 的 
基本 原理 和 概念 ， 并 且 最 后 我 们 将 产生 这 个 简单 但 专业 的 应 用 程序 。 本 章 位 于 先前 
基本 概念 章节 和 后 面 对 wxPython 功能 更 详细 讨论 的 2、3 部 分 之 间 。 


我 们 在 本 章 将 建造 的 这 个 应 用 程序 基本 上 基于 wxPython / samples 目录 中 的 涂 
鸦 例子 。 这 个 应 用 程序 是 一 个 非常 简单 的 绘画 程序 ， 和 鼠标 堪 键 按 下 时 它 跟踪 鼠标 
指针 ， 并 画 线 。 图 6.1 显 示 了 一 个 简单 的 初始 绘画 窗口 


图 6.1 





F7 Sketch Frame luti 





Figure 6.1 A simple sketch window, with no further decorations 


我 们 之 所 以 要 选择 这 样 一 个 绘画 例子 ， 是 因为 它 是 十 分 简单 的 程序 ， 它 演示 了 在 创 
建 更 复杂 的 应 用 程序 时 所 引出 的 许多 问题 。 在 本 章 ， 我 们 将 给 你 展示 如 何在 屏幕 上 
画 线 、 添 加 状态 栏 、 工 具 样 以 及 菜单 栏 。 你 将 会 看 到 如 何 使 用 通用 对 话 框 ， 如 文件 
选择 器 和 顾 色 选择 器 。 我 们 将 使 用 sizer 来 布置 窗口 部 件 ， 并 且 我 们 也 将 增加 一 
个 关于 框 和 一 个 启动 画面 。 本 童 的 最 后 ， 你 将 有 一 个 很 好 看 的 绘画 程 序 。 


det RL B 


你 的 绘画 程序 的 首先 的 工作 是 勾画 线条 并 显示 出 来 。 像 其 它 的 GUI 工具 一 样 ， 
wxPython 提供 了 一 套 独立 于 设备 的 工具 用 于 绘画 。 下 面 ， 我 们 将 讨论 如 何在 屏幕 


上 绘画 。 


如 何在 屏幕 上 绘画 


要 在 屏幕 上 绘画 ， 我 们 要 用 到 一 个 名 为 device context (设备 上 下 文 ) 

的 wxPython 对 象 。 设 备 上 下 文 代表 抽象 的 设备 ， 它 对 于 所 有 的 设备 有 一 套 公 用 的 
绘画 方法 ， 所 以 对 于 不 同 的 设备 ， 你 的 代码 是 相同 的 ， 而 不 用 考虑 你 所 在 的 具体 设 
备 。 设 备 上 下 文 使 用 抽象 的 wxPython 的 类 wx.DC 和 其 子 类 来 代表 。 由 

于 wx.DC 是 抽象 的 ， 所 以 对 于 你 的 应 用 程序 ， 你 需要 使 用 它 的 子 类 。 


使 用 设备 上 下 文 


表 6.1 显 示 了 wx.DC 的 子 类 及 其 用 法 。 设 备 上 下 文 用 来 在 wxPython 窗口 部 件 上 
绘画 ， 它 应 该 是 局 部 的 ， 临 时 性 的 ， 不 应 该 以 实例 变量 、 全 局 变量 或 其 它 形式 在 方 
法 调用 之 间 保 留 。 在 某 些 平台 上 ， 设 备 上 下 文 是 有 限 的 资源 ， 长 期 持 有 wx.DC 可 
能 导致 你 的 程序 不 稳定 。 由 于 wxPython 内 部 使 用 设备 上 下 文 的 方式 ， 对 于 在 窗口 
部 件 中 绘画 ， 就 存在 几 个 有 着 细微 差别 的 wx.DC 的 子 类 。 第 十 二 章 将 更 详细 地 说 
明 这 些 差别 。 


表 6.1 


wx.BufferedDC : 用 于 缓存 一 套 绘 画 命令 ， 直 到 命令 完整 并 准备 在 屏幕 上 绘画 。 
这 防止 了 显示 中 不 必要 的 闪烁 。 


wx.BufferedPaintDC :和 wx.BufferedDC 一 样 ， 但 是 只 能 用 在 一 
个 wx.PaintEvent 的 处 理 中 。 仅 临时 创建 该 类 的 实例 。 


wx,ClLientDC : 用 于 在 一 个 窗口 对 象 上 绘画 。 当 你 想 在 窗口 部 件 的 主 区 域 上 (不 
包括 边框 或 别 的 装饰 ) 绘画 时 使 用 它 。 主 区 域 有 时 也 称 为 客户 

区 。 wx.ClientDC 类 也 应 临时 创建 。 该 类 仅 适 用 于 wx.PaintEvent 的 处 理 之 
外 。 


wx.MemoryDC : 用 于 绘制 图 形 到 内 存 中 的 一 个 位 图 中 ， 此 时 不 被 显示 。 然 后 你 可 
以 选择 该 位 图 ， 并 使 用 wx.DC.Blit() 方法 来 把 这 个 位 图 绘画 到 一 个 窗口 中 。 


wx.MetafileDC : 在 Windows 操作 系统 上 ， wx.MetafileDC 使 你 能 够 去 创建 
标准 窗口 图 元 文件 数据 。 


wx.PaintDC :等 同 于 wx.clientDC ， 除 了 它 仅 用 于 一 个 wx.PaintEvent 的 处 
理 中 。 仅 临时 创建 该 类 的 实例 。 


wx.PostScriptDC : 用 于 写 压 缩 的 PostScript 文件 。 
wx.PrinterDC : 用 于 windows 操作 系统 上 ， 写 到 打印 机 。 


wx.ScreenDC 直接 在 屏幕 上 绘画 ， 在 任何 被 显示 的 窗口 的 顶部 或 外 部 。 该 
类 只 应 该 被 临 m ux 


wx.WindowDC : 用 于 在 一 个 窗口 对 象 的 整个 区 域 上 绘画 ， 和 包括 边框 以 及 那些 没有 
被 包括 在 客户 区 域 中 的 装饰 。 非 Windows 系统 可 能 不 支持 该 类 。 


下 例 6.1 包 含 了 显示 图 6.1 的 代码 。 因 为 该 代码 展示 了 基于 设备 上 下 文 绘画 的 技巧 ， 
所 以 我 们 将 对 其 详细 注释 。 


例 6.1 初始 的 Sketchwindow 代码 


import wx 


class SketchWindow(wx.Window) : 
def — init (self, parent, ID): 
wx.Window. init (self, parent, ID) 
self.SetBackgroundColour ("White") 
self.color = "Black" 
self.thickness = 1 
self.pen = wx.Pen(self.color, self.thickness, wx.SOLID)# 
创建 一 个 wx . Pen xt & 
self.lines = [] 
self.curLine = [] 
self.pos = (0, 0) 
self .InitBuffer() 


2 连接 事件 
self.Bind(wx.EVT LEFT DOWN, self.OnLeftDown) 
self.Bind(wx.EVT LEFT UP, self.OnLeftUp) 
self.Bind(wx.EVT MOTION, self.OnMotion) 
self.Bind(wx.EVT SIZE, self.OnSize) 
self.Bind(wx.EVT IDLE, self.OnIdle) 
self.Bind(wx.EVT PAINT, self.OnPaint) 


def InitBuffer(self): 
size = self.GetClientSize() 


#3 创建 一 个 缓存 的 设备 上 下 文 
self.buffer = wx.EmptyBitmap(size.width, size.height) 
dc = wx.BufferedDC(None, self.buffer) 


#4 使 用 设备 上 下 文 
dc.SetBackground(wx.Brush(self.GetBackgroundColour())) 
dc.Clear() 
self.DrawLines(dc) 


动 


self.reInitBuffer = False 


def GetLinesData(self): 
return self.lines[:] 


def SetLinesData(self, lines): 
self.lines = lines[:] 
self .InitBuffer() 
self .Refresh() 


def OnLeftDown(self, event): 
self.curLine = [] 
self.pos = event.GetPositionTuple()45 #2] Rist (2 E 
self .CaptureMouse()#6 捕获 鼠标 


def OnLeftUp(self, event): 
if self.HasCapture(): 
self.lines.append((self.color, 
self.thickness, 
self.curLine) ) 
self.curLine = [] 
self .ReleaseMouse()#7 释放 和 鼠标 


def OnMotion(self, event): 
if event.Dragging() and event.LeftIsDown():#8 确定 是 否 在 拖 


dc = wx.BufferedDC(wx.ClientDC(self), self.buffer)#9 


创建 另 一 个 缓存 的 上 下 文 


self.drawMotion(dc, event) 

event .Skip() 

#10 绘画 到 设备 上 下 文 

def drawMotion(self, dc, event): 
dc.SetPen(self.pen) 
newPos - event.GetPositionTuple() 
coords = self.pos + newPos 
self .curLine.append(coords) 
dc.DrawLine(*coords) 
self.pos - newPos 


def OnSize(self, event): 
self.relnitBuffer = True #11 处 理 一 个 resize 事 件 


def OnIdle(self, event):#12 空闲 时 的 处 理 
if self.reInitBuffer: 
self .InitBuffer() 
self .Refresh(False) 


def OnPaint(self, event): 
dc = wx.BufferedPaintDC(self, self.buffer)#13 处 理 一 个 pai 


nt (描绘 ) 请 求 


#14 绘制 所 有 的 线条 


def DrawLines(self, dc): 
for colour, thickness, line in self.lines: 
pen = wx.Pen(colour, thickness, wx.SOLID) 
dc.SetPen( pen) 
for coords in line: 
dc .DrawLine(*coords) 


def SetColor(self, color): 
self.color = color 
self.pen = wx.Pen(self.color, self.thickness, wx.SOLID) 


def SetThickness(self, num): 
self.thickness = num 
self.pen = wx.Pen(self.color, self.thickness, wx.SOLID) 


class SketchFrame(wx.Frame): 
def _ init__(self, parent): 
wx.Frame.__init__(self, parent, -1, "Sketch Frame", 
size-(800,600)) 
self.sketch - SketchWindow(self, -1) 


if name == ' main ': 
app - wx.PySimpleApp() 
frame = SketchFrame(None) 
frame.Show( True) 
app .MainLoop( ) 


说 明 : 


#1: wx.Pen 实例 决定 绘画 到 设备 上 下 文 的 线条 的 颜色 、 粗 细 和 样式 。 样 式 除 
了 wx.SOLID 还 有 wx.DOT , wx.LONGDASH ,和 wx.SHORTDASH ° 


#2 : 窗口 需要 去 响应 几 个 不 同 的 鼠标 类 型 事件 以 便 绘 制图 形 。 响 应 的 事件 有 鼠标 左 
键 按 下 和 释放 、 和 鼠标 移动 、 窗 口 大 小 变化 和 窗口 重 绘 。 这 里 也 指定 了 空闲 时 的 处 
理 。 


#3: 用 两 步 创 建 了 缓存 的 设备 上 下 文 : (1) 创建 空 的 位 图 ， 它 作为 画面 外 

( offscreen) 的 缓存 (2) 使 用 画面 外 的 缓存 创建 一 个 缓存 的 设备 上 下 文 。 这 个 组 
存 的 上 下 文 用 于 防止 我 勾画 线 的 重 绘 所 引起 的 屏幕 闪烁 。 在 这 节 的 较 后 面 的 部 分 ， 
我 们 将 更 详细 地 讨论 这 个 缓存 的 设备 上 下 文 。 


#4 : 这 几 行 发 出 绘制 命令 到 设备 上 下 文 ; 具体 就 是 ， 设 置 背景 色 并 清空 设备 上 下 文 
( dc.Clear()) 。 必 须 调用 dc.Clear() ， 其 作用 是 产生 一 个 wx.EVT_PAINT 事 
件 ， 这 样 ， 设 置 的 背景 就 显示 出 来 了 ， 否 则 屏幕 颜色 不 会 改变 。 wx.Brush 对 象 决 
定 了 背景 的 颜色 和 样式 。 


#5 : 事件 方法 GetPositionTuple() 返回 一 个 包含 鼠标 敲 击 的 精确 位 置 
的 Python 元 组 。 


86: CaptureMouse() 方法 控制 了 鼠标 并 在 窗口 的 内 部 捕获 鼠标 ， 即 使 是 你 拖 动 
鼠标 到 窗口 边框 的 外 面 ， 它 仍然 只 响应 窗口 内 的 鼠标 动作 。 在 程序 的 后 面 必 须 调 
用 ReleaseMouse() 来 取消 其 对 鼠标 的 控制 。 否 则 该 窗口 将 无 法 通过 鼠标 关闭 
等 ， 试 将 #7 注释 掉 。 


#7 : ReleaseMouse() 方法 将 系统 返回 到 调用 CaptureMouse() 之 前 的 状 
Æ ° wxPython 应 用 程序 使 用 一 个 椎 栈 来 对 捕获 了 鼠标 的 窗口 的 跟踪 ， 调 
用 ReleaseMouse() 相当 于 从 椎 栈 中 弹出 。 这 意味 着 你 需要 调用 相同 数据 


的 CaptureMouse() 和 ReleaseMouse() ° 


#8 : 这 行 确定 移动 事件 是 否 是 线条 绘制 的 一 部 分 ， 由 移动 事件 发 生 时 鼠标 左 键 是 否 
处 于 按 下 状态 来 确定 。 Dragging() 和 LeftIsDown() 都 是 wx.MouseEvent 的 
方法 ， 如 果 移 动 事件 发 生 时 所 关联 的 条 件 成 立 ， 方 法 返回 true 。 


#9: 由 于 wx.BufferedDC 是 一 个 临时 创建 的 设备 上 下 文 ， 所 以 在 我 们 绘制 线条 之 
前 需要 另外 创建 一 个 。 这 里 ， 我 们 创建 一 个 新 的 wx.CLientDC 作为 主要 的 设备 上 
下 文 ， 并 再 次 使 用 我 们 的 实例 变量 位 图 作为 缓存 。 


#10 : 这 几 行 实际 是 使 用 设备 上 下 文 去 绘画 新 近 的 勾画 线 到 屏幕 上 。 首 先 ， 我 们 创 

建 了 coords 元 组 ， 它 合并 了 self.pos 和 newPos 元 组 。 这 里 ， sd 

于 事件 GetPositionTuple() ， 老 的 位 置 是 最 后 对 OnMotion() 调用 所 得 到 的 

我 们 把 该 元 组 保存 到 self.curLine 列表 中 ， 然 后 调用 DrawLine() ° 

* coords 返回 元 组 coords 中 的 元 素 x1, y1, x2, y2 ° DrawLine() 方法 
要 求 的 参数 形 如 x1 ，y1 , x2, y2 ， 并 从 点 ( x1, y1) 到 ( x2, y2) 绘制 一 

线 。 勾 画 的 速度 依赖 于 底层 系统 的 速度 


#11: 如 果 窗 口 大 小 改变 了 ， 我 们 存储 一 个 True 值 到 self.reInitBuffer 实例 
属性 中 。 我 们 实际 上 不 做 任何 事 直到 下 一 个 空闲 事件 。 


#12: 当 一 个 空闲 产生 时 ， 如 果 已 发 生 了 一 个 或 多 个 尺寸 改变 事件 ， 这 个 应 用 程序 
抓 住 时 机 去 响应 一 个 尺寸 改变 事件 。 我 们 存储 一 个 True 值 

到 self.reInitBuffer 实例 属性 中 ， 并 在 一 个 空闲 产生 时 响应 的 动机 是 避免 对 于 
接二连三 的 尺寸 改变 事件 都 进行 屏幕 刷新 。 


#13 : 对 于 所 有 的 显示 要 求 ， 都 将 产生 wx.EVT_PAINT 事件 (描绘 事件 ) ， 并 调用 
我 们 这 里 的 方法 OnPaint 进行 屏幕 刷新 〈 重 绘 ) ， 你 可 以 看 到 这 是 出 乎 意料 的 简 
单 : 创建 一 个 缓存 的 画图 设备 上 下 文 。 实 际 上 wx.PaintDC 被 创建 (因为 我 们 处 
在 一 个 Paint 请 求 里 ， gau dus wx.PaintDC 而 非 一 个 wx.ClientDC £X 
例 ) ， ee dc 实例 被 删除 后 (函数 返回 时 被 销毁 ) > 位 图 被 一 块 块 地 传送 

( blit) 给 屏幕 并 最 终 显示 。 TRE REI MS 息 将 在 随后 的 段落 中 提供 。 


#14: 当 由 于 尺寸 改变 (和 由 于 从 文件 载 入 ) 而 导致 应 用 程序 需要 根据 实际 数据 重 
绘 线 条 时 ， 被 使 用 。 这 里 ， 我 们 人 遍历 存储 在 实例 变量 self.lines 中 行 的 列表 ， 
为 每 行 重 新 创建 画笔 ， 然 后 根据 坐标 绘制 每 一 条 线 。 


这 个 例子 使 用 了 两 个 特殊 的 wx.DC 的 子 类 ， 以 使 用 绘画 缓存 。 一 个 绘画 缓存 是 一 
个 不 显现 的 区 域 ， 其 中 存储 了 所 有 的 绘画 命令 (这些 命 令 能 够 一 次 被 执行 ) ， 并 且 
一 步 到 位 地 复制 到 屏幕 上 。 缓 存 的 好 处 是 用 户 看 不 到 单个 绘画 命令 的 发 生 ， 因 此 愤 


幕 不 会 闪烁 。 正 因 如 此 ， 缓 存 被 普遍 地 用 于 动画 或 绘制 是 由 一 些小 的 部 分 组 成 的 场 
A o 


在 wxPython 中 ， 有 两 个 用 于 缓存 的 类 : wx.BufferDC (通常 用 于 缓存 一 

个 wx.ClientDC ) ^ wx.BufferPaintDC (用 于 缓存 一 个 wx.PaintDC ) ° € 
们 工作 方式 基本 上 一 样 。 缓 存 设 备 上 下 文 的 创建 要 使 用 两 个 参数 。 第 一 个 是 适当 类 
型 的 目标 设备 上 下 文 (例如 ， 在 例 6.1 中 的 #9， 它 是 一 个 新 的 _ wx.CLientDCc È 
例 ) 。 第 二 个 是 一 个 wx.Bitmap 对 象 。 在 例 6.1 中 ， 我 们 使 用 遂 

数 wx.EmptyBitmap 创建 一 个 位 图 。 当 绘画 命令 到 缓存 的 设备 上 下 文 时 ， 一 个 内 
在 的 wx.MemoryDC 被 用 于 位 图 绘制 。 当 缓存 对 象 被 销毁 时 ，C++ 销 毁 器 使 

用 Blit() 方法 去 自动 复制 位 图 到 目标 。 在 wxPython 中 ， 销 毁 通 常 发 生 在 对 象 
退出 作用 域 时 。 这 意味 缓存 的 设备 上 下 文 仅 在 临时 创建 时 有 用 ， 所 以 它们 能 够 被 销 
毁 并 能 用 于 块 传送 ( blit) 。 


例如 例 6.1 的 OnPaint () 方法 中 ， self.buffer 位 图 在 建造 勾画 ( sketch ) 
期 间 已 经 被 写 了 。 只 需要 创建 缓存 对 象 ， 从 而 建立 关于 窗口 的 已 有 的 位 图 与 临 

时 wx.PaintDC() 之 间 的 连接 。 方 法 结束 后 ， 缓 存 DC 立即 退出 作用 域 ， 触 发 它 
的 销毁 器 ， 同 时 将 位 图 复制 到 屏幕 。 


设备 上 下 文 的 函数 


当 你 使 用 设备 上 下 文 时 ， 要 记 住 根据 你 的 绘制 类 型 去 使 用 恰当 的 上 下 文 (特别 要 记 
住 wx.PaintDC 和 wx.ClientDC 的 区 别 ) 。 一 旦 你 有 了 适当 的 设备 上 下 文 ， 然 
后 你 就 可 以 用 它们 来 做 一 些 事情 了 。 表 6.2 列 出 了 wx.DC 的 一 些 方法 。 


表 6.2 wx.DC 的 常用 方法 


Blit(xdest , ydest , width , height , source , xsrc , ysrc) : MI 
备 上 下 文 复制 块 到 调用 该 方法 的 设备 上 下 文 。 参 数 xdest , ydest 是 复制 到 目标 
上 下 文 的 起 始点 。 接 下 来 的 两 个 参数 指定 了 要 复制 的 区 域 的 宽度 和 高 
度 。 source 是 源 设备 上 下 文 ， xsrc , ysrc 是 源 设备 上 下 文中 开始 复制 的 起 
点 。 还 有 一 些 可 选 的 参数 来 指定 逻辑 司 加 功能 和 掩 码 。 


Clear() :通过 使 用 当前 的 背景 刷 米 清除 设备 上 下 文 。 


DrawArc(x1 , yl , x2, y2, xe ，yc) :使 用 起 点 ( xa, y1) 和 终点 
(x2, y2) &-—^FB (xc, yc) CHM PS o MIME A 3 ay Ay m HFA HK o 
这 个 函数 按 逆 时 针 画 。 这 也 有 一 个 相关 的 方法 DrawEllipticalArc() ° 


DrawBitmap(bitmap ,X,y, transparent) : 绘制 一 个 wx.Bitmap 对 象 ， 起 点 
A(x, y) 。 如 果 transparent Ax > Pp X | ay E AAS 38 9] Ag © 


DrawCircle(x ,y, radius) DrawCircle(point , radius) : 按 给 定 的 中 心 
点 和 半径 画 圆 。 这 也 有 一 个 相关 的 方法 DrawEllipse 。 


DrawIcon(icon ,X, y) :绘制 一 个 wx.Icon 对 象 到 上 下 文 ， 起 点 是 (X，y) ° 


DrawLine(xi , y1, x2, y2) :从 点 ( x1, y1) 到 ( x2, y2) 画 一 条 线 。 
这 有 一 个 相关 的 方法 DrawLines() ， 该 方法 要 wx.Point 对 象 的 一 
个 Python 列表 为 参数 ， 并 将 其 中 的 点 连接 起 来 。 


DrawPolygon(points) : 按 给 定 的 wx.Point 对 象 的 一 个 Python 列表 绘制 一 
个 多 边 形 。 与 DrawLines() 不 同 的 是 ， 它 的 终点 和 起 点 相连 。 多 边 形 使 用 当前 的 
画 刷 来 填充 。 这 有 一 些 可 选 的 参数 来 设置 x 和 y 的 偏 移 以 及 填充 样式 。 


DrawRectangle(x ,y, width , height) : 绘制 一 个 矩形 ， 它 的 左上 角 是 (x， 
y) ， 其 宽 和 高 是 width 和 height 


o 


DrawText(text ,X, y) : AA A(x, y) 开始 绘制 给 定 的 字符 串 ， 使 用 当前 的 字 
体 。 相 关 函 数 包 括 DrawRotatedText() 和 GetTextExtent() 。 文 本 项 有 前 景色 
和 背景 色 属 性 。 


FloodFill(x ,y, color , style) : 从 点 (X，y) 执行 一 个 区 域 填 充 ， 使 用 当前 
画 刷 的 颜色 。 参 数 style 是 可 选 的 。 style 的 默认 值 是 wx.FLOOD_SURFACE ， 
它 表示 当 卉 充 碰 到 另 一 颜色 时 停止 。 另 一 值 wx.FLOOD BORDER 表示 参 

数 color 是 填充 的 边界 ， 当 十 充 碰 到 该 颜色 的 代表 的 边界 时 停止 。 


GetBackground()  SetBackground(brush) : 背景 画 刷 是 一 个 wx.Brush 对 


$.* 3S clear() 方法 被 调用 时 使 用 。 


GetBrush() SetBrush(brush) : 画 刷 是 一 个 wx.Brush 对 象 并 且 用 于 填充 任 
何 绘制 在 设备 上 下 文 上 的 形状 。 


GetFont() SetFont(font) : 字体 ( font) 是 一 个 wx.Font 对 象 ， 被 用 于 所 
有 的 文本 绘制 操作 。 


GetPen() SetPen(pen) : £9 €( pen) 是 一 个 wx.Pen 对 象 ， 被 用 于 所 有 绘制 
线条 的 操作 。 


GetPixel(x , y) :返回 一 个 关于 点 (X，y) 的 像素 的 一 个 wx.Colour 4H ° 


GetSize() GetSizeTuple() : 以 一 个 wx.Size 对 象 或 一 个 Python 元 组 的 
形式 返回 设备 上 下 文 的 像素 尺寸 。 


上 面 的 列表 并 没有 党 括 所 有 的 方法 。 另 外 的 一 些 方法 将 在 第 十 二 章 中 说 明 。 
添加 窗口 装饰 
尽管 绘制 到 屏幕 是 一 个 画图 程序 不 可 或 缺 的 部 分 ， 但 是 它 距 美观 的 程序 还 差 的 远 。 


在 这 一 节 ， 我 们 将 谈 及 常用 的 窗口 装饰 : 状态 栏 、 菜 单 和 工具 栏 。 我 们 将 在 第 10 章 
对 这 些 做 更 详细 的 讨论 。 


如 何 添加 和 更 新 一 个 状态 栏 


在 wxPython 中 ， 你 可 以 通过 调用 框架 的 CreatestatusBar() 方法 添加 并 放置 
一 个 状态 栏 到 一 个 框架 的 底部 。 当 父 框架 调整 大 小 的 时 候 ， 状 态 栏 自动 的 自我 调整 
大 小 。 默 认 情 况 下 ， 状 态 栏 是 类 wx.StatusBar 的 一 个 实例 。 要 创建 一 个 自 定 义 


的 状态 栏 ， 要 使 用 SetstatusBar() 方法 并 要 求 你 的 新 类 的 实例 作为 参数 来 将 状 
态 栏 附着 到 你 的 框架 上 。 


要 在 你 的 状态 栏 上 显示 单一 的 一 段 文本 ， 你 可 以 使 
用 wx.StatusBar 的 SetStatusText() 方法 。 例 6.2 扩 展 了 在 例 6.1 中 所 演示 
的 SketchFrame 类 来 在 状态 栏 中 显示 当前 和 鼠标 的 位 置 。 


例 6.2 给 框架 添加 一 个 简单 的 状态 栏 


# python 
import wx from example1 import SketchWindow 
class SketchFrame(wx.Frame): 


def init(self, parent): 
wx.Frame.init(self, parent, -1, "Sketch Frame", 
size=(800, 600) ) 
self.sketch = SketchWindow(self, -1) 
self.sketch.Bind(wx.EVT_MOTION, self.OnSketchMotion) 
self.statusbar = self.CreateStatusBar() 


def OnSketchMotion(self, event): 
self.statusbar.SetStatusText(str(event.GetPositionTuple( 


))) 
event .Skip() 


if name == 'main': 
app = wx.PySimpleApp() 
frame = SketchFrame(None) 
frame.Show(True) 
app .MainLoop( ) 


我 们 通过 使 框架 捕捉 勾画 窗 的 wx. EVT_MOTION 事件 来 在 状态 栏 中 显示 筷 标 位 置 。 
事件 处 理 器 使 用 由 该 事件 提供 的 数据 设置 状态 栏 的 文 ? 尽 耳 缓 赚 讲 甸 方 法 来 保证 另 
外 的 onMotion() 方法 被 调用 ， 否 则 线条 将 不 被 绘制 。 


如 果 你 想 在 状态 栏 中 显示 多 个 文本 元 素 ， 你 可 以 在 状态 栏 中 创建 多 个 文本 域 。 要 使 
用 这 个 功能 ， 你 要 调用 SetFieldscount() 方法 ， 其 参数 是 域 的 数量 ; 默认 情况 
下 只 有 我 们 先前 所 见 的 那 一 个 域 。 这 之 后 使 用 先前 的 SetStatusText() ， 但 是 要 
使 用 第 二 个 参数 来 指定 此 方法 所 应 的 域 。 域 的 编号 从 0 开始 。 如 果 你 不 指定 一 个 
域 ， 那 么 默认 为 设置 第 0 号 域 ， 这 也 说 明了 为 什么 我 们 没有 指定 域 而 先前 的 例子 能 
工作 。 


默认 情况 下 ， 每 个 域 的 宽度 是 相同 的 。 要 调整 文本 域 的 尺寸 ，wxPython 提供 

了 SetstatusWidth() 方法 。 该 方法 要 求 一 个 整数 的 Python 列表 作为 参数 ， 列 
表 的 长 度 必须 和 状态 栏 中 哉 的 数量 一 致 。 按 列表 中 整数 的 顺序 来 计算 对 应 域 的 宽 
度 。 如 果 整 数 是 正 值 ， 那 么 宽度 是 国定 的 。 如 果 你 想 域 的 宽度 随 框架 的 变化 而 变 


化 ， 那 么 应 该 使 用 负 值 。 负 值 的 绝对 值 代表 域 的 相对 宽度 ; 可 以 把 它 认为 是 所 占 总 
宽度 的 比例 。 例 如 调用 statusbar. SetStatusWidth( [-1, -2,-3]) 方 法 所 导致 的 各 
域 从 左 到 右 的 宽度 比例 是 1:2:3。 图 6.2 显 示 了 这 个 结果 。 


图 6.2 


Pos: (609, 213) Current Pts: 39 Line Count: 4 | 





Figure 6.2 A sample status bar with the fields getting 1/6, 2/3, and 1/2 of the total width 


例子 6.3 增 加 了 两 个 状态 其 中 一 个 显示 所 绘 的 当前 线条 的 点 数 ， 另 一 个 显示 当前 
所 画 的 线条 


例 6.3 支持 多 个 状态 域 


import wx 
from examplei import SketchWindow 


class SketchFrame(wx.Frame): 

def — init (self, parent): 

wx.Frame. init (self, parent, -1, "Sketch Frame", 
size=(800, 600)) 

self.sketch = Sketchwindow(self, -1) 
self.sketch.Bind(wx.EVT MOTION, self.OnSketchMotion) 
self.statusbar - self.CreateStatusBar() 
self.statusbar.SetFieldsCount(3) 
self.statusbar.SetStatusWidths([-1, -2, -3]) 


def OnSketchMotion(self, event): 

self.statusbar.SetStatusText("Pos: 96s" 96 
str(event.GetPositionTuple()), 0) 

self.statusbar.SetStatusText("Current Pts: 96s" 96 
len(self.sketch.curLine), 1) 

self.statusbar.SetStatusText("Line Count: %s" 96 
len(self.sketch.lines), 2) 

event.Skip() 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = SketchFrame(None) 
frame.Show(True) 
app.MainLoop() 


StatusBar 类 使 你 能 够 把 状态 域 当 作 一 个 后 进 先 出 的 堆栈 。 尽 管 本 章 的 演示 程序 
没有 这 样 用 ， Pushstatus - Text() 和 PopStatusText() 使 得 你 能 够 在 临时 显 
示 新 的 文本 之 后 返回 先前 的 状态 文本 。 这 两 个 方法 都 有 一 个 可 选 的 域 号 参数 ， 以 便 
在 多 个 状态 域 的 情况 下 使 用 。 


表 6.3 归 纳 了 wx.StatusBar 最 常用 的 方法 


表 6.3 wx.StatusBar 的 方法 


GetFieldsCount()  SetFieldsCount(count) :得 到 或 设置 状态 栏 中 域 的 数 
£e 


GetStatusText(field =0) SetstatusText(text , field 20): 得 到 或 设置 指 
定 域 中 的 文本 。0 是 默认 值 ， 代表 最 左 端的 域 。 


PopStatusText(field =O) : 弹出 堆栈 中 的 文本 到 指定 域 中 ， 以 改变 域 中 的 文本 
为 弹 出 值 。 


PushStatusText(text , field =0) : 改变 指定 的 域 中 的 文本 为 给 定 的 文本 ， 并 
将 改变 前 的 文本 压 入 堆栈 的 顶部 。 


SetStatusWidths(widths) : 指定 各 状态 域 的 宽度 。 widths 是 一 个 整数 
的 Python 列表 。 


在 第 10 章 中 ， 我 们 将 对 状态 栏 作 更 详细 的 说 明 。 下 面 我 们 将 讨论 菜单 。 


如 何 添 加 菜单 ? 

本 节 ， 我 们 将 说 明 如 何 添加 子 菜单 和 复 选 或 单 选 菜单 。 子 菜 > ens 
单 。 复 制 菜单 或 单 选 菜单 是 一 组 菜单 项 ， 它 们 的 行为 类 似 于 一 组 复 选 框 或 单 选 
钮 。 图 6.3 显 示 了 一 个 菜单 栏 ， 其 中 的 一 个 子 菜单 包含 了 单 选 菜单 项 。 


图 6.3 





Sketch Frame 








Figure 6.3 

A menu that uses 
a submenu with 
radio menu items 


要 创建 一 个 子 菜单 ， 首 先 和 创建 别 的 菜单 方法 一 样 创建 一 个 菜单 ， 然 后 再 使 
用 wx.Menu.AppendMenu() 将 它 添加 给 父 菜单 。 


带 有 复 选 或 单 选 菜单 的 菜单 可 以 通过 使 

用 wx.Menu 的 ET fe AppendRadioItem() 方法 来 创建 ， 或 通 
过 在 wx.MenuItem 的 创建 器 中 使 参数 kind 的 属性 值 为 下 列 之 一 来 创 

建 : wx.ITEM NORMAL , a ,或 wx.ITEM_ RADIO o 要 使 用 编 
程 的 方法 来 选择 一 个 菜单 项 ， 可 以 使 wx.Menu 的 Check(id , bool) 方 

法 ，id 是 所 要 改变 项 的 wxPython ID ， bool 指定 了 该 项 的 选择 状态 。 


例 6.4 为 我 们 初始 的 绘画 程序 添加 了 菜单 支持 。 我 们 这 里 的 菜单 改进 自 例 5.5 中 的 被 
重 构 的 公用 程序 代码 o 


例子 6.4 


import wx 
from examplei import SketchWindow 


class SketchFrame(wx.Frame): 


def 


def 


def 


def 


def 


. Anit (self, parent): 

wx.Frame. init__(self, parent, -1, "Sketch Frame", 
size-(800,600)) 

self.sketch - SketchWindow(self, -1) 

self.sketch.Bind(wx.EVT MOTION, self.OnSketchMotion) 

self.initStatusBar() #1 这 里 因 重 构 有 点 变化 

self.createMenuBar() 


initStatusBar(self): 

self.statusbar - self.CreateStatusBar() 
self.statusbar.SetFieldsCount(3) 
self.statusbar.SetStatusWidths([-1, -2, -3]) 


OnSketchMotion(self, event): 

self.statusbar.SetStatusText("Pos: 96s" 96 
str(event.GetPositionTuple()), 0) 

self.statusbar.SetStatusText("Current Pts: 96s" 96 
len(self.sketch.curLine), 1) 

self.statusbar.SetStatusText("Line Count: %s" 96 
len(self.sketch.lines), 2) 

event.Skip() 


menuData(self): 42 菜单 数据 


return [(" ", ( 
(" ", "New Sketch file", self.OnNew), 
(" ", "Open sketch file", self.OnOpen), 
(" ", "Save sketch file", self.OnSave), 
LT HA yr 
(G aem ( 
ju us Ne self.OnColor, 


WwX.ITEM RADIO), 
(OO UESed nc ON COLON, 
WwX.ITEM RADIO), 
(CselfaonColor 
wx.ITEM_RADIO), 
Ce Sel Oncolor, 
wx. ITEM_RADIO))), 


(IE ion ME 


(" ", "Quit", self.OnCloseWindow)))] 


createMenuBar (self): 

menuBar = wx.MenuBar() 

for eachMenuData in self.menuData(): 
menuLabel = eachMenuData[0] 
menultems = eachMenuData[1] 


menuBar.Append(self.createMenu(menuItems), menuLabel 


self .SetMenuBar (menuBar ) 


def createMenu(self, menuData): 
menu = wx.Menu() 
#3 创建 子 菜 
for eachItem in menuData: 
if len(eachItem) == 

label = eachItem[0] 
subMenu = self.createMenu(eachItem[1]) 
menu.AppendMenu(wx.NewId(), label, subMenu) 


else: 
self.createMenuItem(menu, *eachItem) 
return menu 


def createMenuItem(self, menu, label, status, handler, 
kind-wx.ITEM NORMAL): 

if not label: 
menu.AppendSeparator() 
return 

menuItem = menu.Append(-1, label, status, kind)#4 使 用 kin 

d 创 建 菜单 项 
self.Bind(wx.EVT MENU, handler, menultem) 


def OnNew(self, event): pass 
def OnOpen(self, event): pass 
def OnSave(self, event): pass 


def OnColor(self, event):#5 处 理 颜 色 的 改变 
menubar = self.GetMenuBar() 
itemId = event.GetId() 
item = menubar .FindItemById(itemId) 
color = item.GetLabel() 
self.sketch.SetColor(color ) 


def OnCloseWindow(self, event): 
self .Destroy() 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = SketchFrame (None) 
frame.Show(True) 
app.MainLoop() 


说 明 : 


81: 现在 _ init 方法 包含 了 更 多 的 功能 ， 我 们 把 状态 栏 放 在 了 它 自己 的 方法 
中 o 


#2: 菜单 数据 的 格式 现在 是 (标签 , (项 目 )， 其 中 的 每 个 顶 目 也 是 一 个 列表 (标签 , 48 
ALF, 处 理 器 , 可 选 的 kind) 或 一 个 带 有 标签 和 项 目的 菜单 。 确 定数 据 的 一 个 子 
项 目 是 菜单 还 是 一 个 菜单 项 ， 请 记 住 ， 菜 单 的 长 度 是 2， 项 目的 长 度 是 3 或 4。 对 于 
更 复杂 的 产品 数据 ， 我 建议 使 用 XML 或 别 的 外 部 格式 。 


#3 : 如 果 数 据 块 的 长 度 是 2， 这 意味 它 是 一 个 菜单 ， 将 之 分 开 ， 并 递归 调 
用 createMenu ， 然 后 将 之 添加 。 


#4 : 创建 菜单 项 。 对 wx.MenuItem 的 构造 器 使 用 kind 参数 的 方法 比 使 
用 wx.Menu 的 特定 方法 更 容易 。 


#5: Oncolor 方法 根据 所 选 菜单 项 来 改变 画笔 的 颜色 。 代 码 根据 事件 得 到 项 目 
的 id ， 再 使 用 FindItemById() 来 得 到 正确 的 菜单 项 (注意 我 们 这 里 使 用 菜 记 
栏 作为 数据 结构 来 访问 ， 而 没有 使 用 项 目 id 的 哈 希 表 ) ， 这 个 方法 是 以 标签 
是 wxPython 颜色 名 为 前 提 的 。 


如 何 添 加 一 个 工具 栏 


菜单 栏 和 工具 栏 通常 是 紧密 联系 在 一 起 的 ， 工 具 栏 的 绝 大 部 分 功能 与 菜单 项 相对 
应 。 在 wxPython 中 ， 这 通过 工具 栏 被 融 击 时 发 出 wx.EVT MENU 事件 ， 这 样 就 可 
很 容易 地 在 处 理 菜单 项 的 选择 和 工具 栏 的 敲 击 时 使 用 相同 的 方法 。 一 

个 wxPython 工具 栏 是 类 wx.ToolBar 的 一 个 实例 ， 正 如 我 们 在 第 二 章 中 所 见 
的 ， 可 以 使 用 框架 的 方法 CreateToolBar() 来 创建 。 和 状态 栏 一 样 ， 工 具 栏 的 大 
小 也 随 其 父 框架 的 改变 而 自动 改变 。 工 具 栏 与 其 它 的 wxPython 窗口 一 样 可 以 拥有 
任意 的 子 窗口 。 工 具 栏 也 包含 创建 工具 按钮 的 方法 。 图 6.4 显 示 了 带 有 一 个 工具 栏 
的 sketch 窗口 的 一 部 分 ， 这 个 工具 栏 使 用 了 6.2.2 中 菜单 的 相应 方法 ， 以 与 菜 六 
项 的 功能 相对 应 。 


图 6.4 
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Figure 6.4 A typical 
toolbar showing both 
regular and toggle 
buttons 


例 6.5 中 ， 我 们 没有 重复 使 用 菜单 改变 画笔 颜色 的 代码 ， 而 是 使 用 了 新 的 方法 。 


例 6.5 添加 一 个 工具 栏 到 sketch 应 用 程序 


def _ init (self, parent): 
wx.Frame.__init__(self, parent, -1, "Sketch Frame", size= 
(800, 600) ) 
self.sketch = SketchWindow(self, -1) 
self.sketch.Bind(wx.EVT MOTION, self.OnSketchMotion) 
self.initStatusBar() 
self.createMenuBar() 


self .createToolBar () 


def createToolBar(self):419]£ TRE 

toolbar - self.CreateToolBar() 

for each in self.toolbarData(): 
self.createSimpleTool(toolbar, *each) 
toolbar.AddSeparator() 

for each in self.toolbarColorData(): 
self.createColorTool(toolbar, each) 
toolbar.Realize()42 显现 工具 栏 


def createSimpleTool(self, toolbar, label, filename,help, handle 
r ) :#3 创建 常规 工具 
if not label: 
toolbar .AddSeparator ( ) 
return 
bmp = wx.Image(filename,wx.BITMAP TYPE BMP).ConvertToBit 
map() 
tool - toolbar.AddSimpleTool(-1, bmp, label, help) 
self.Bind(wx.EVT MENU, handler, tool) 


def toolbarData(self): 
return (("New", "new.bmp", "Create new sketch", self.OnNe 


w), 

Ga ins E 2E. 

("Open", "open.bmp", "Open existing sketch",self 
.OnOpen), 

("Save", "save.bmp", "Save existing sketch",self 
.OnSave)) 


def createColorTool(self, toolbar, color):#4 创建 闫 色 工 具 
bmp = self.MakeBitmap(color) 
newld = wx.NewId() 
tool = toolbar.AddRadioTool(-1, bmp, shortHelp=color) 
self.Bind(wx.EVT MENU, self.OnColor, tool) 


def MakeBitmap(self, color):#5 创建 纯色 的 位 图 
bmp = wx.EmptyBitmap(16, 15) 
dc = wx.MemoryDC() 
dc.SelectObject (bmp) 
dc.SetBackground(wx.Brush(color) ) 
dc.Clear() 
dc.SelectObject(wx.NullBitmap) 
return bmp 


def toolbarColorData(self): 
return ("Black", "Red", "Green", "Blue") 


def OnColor(self, event):#6 XJ 5 € JR & Vv e T. FEE HRA 
menubar = self.GetMenuBar() 
itemId = event.GetId() 
item = menubar .FindItemById(itemId) 
if not item: 


toolbar = self.GetToolBar() 
item = toolbar.FindById(itemId) 
color = item.GetShortHelp() 
else: 

color = item.GetLabel() 
self.sketch.SetColor(color ) 


#1 : 工具 栏 的 代码 在 设置 上 类 似 于 菜单 代码 。 然 而 ， 这 里 ， 我 们 对 常规 的 按钮 和 单 
选 切换 按钮 使 用 了 不 同 的 循环 设置 。 


#2 : Realize() 方法 实际 上 是 在 工具 栏 中 布局 工具 栏 对 象 。 它 在 工具 栏 被 显示 前 
必须 被 调用 ， 如 果 工 具 栏 中 的 添加 或 删除 了 工具 ， 那 么 这 个 方法 也 必须 被 调用 。 
#3 : 这 个 方法 类 似 于 菜单 项 的 创建 。 主 要 区 别 是 工具 栏 上 的 工具 要 求 显示 位 图 。 这 
里 我 们 使 用 了 三 个 位 于 同一 目录 下 基本 位 图 。 在 该 方法 的 最 后 ， 我 们 绑 定 了 菜单 项 
所 使 用 的 相同 的 wx.EVT MENU 事件 。 


4 : 颜色 工具 的 创建 类 似 于 常规 的 工具 。 唯 一 的 不 同 是 使 用 了 一 个 不 同 的 方法 去 告 
诉 工 具 栏 它们 是 单 选 工具 。 纯 色 的 位 图 由 MakeBitmap() 方法 创建 


#5 : 该 方法 为 单 选 工具 创建 纯色 的 位 图 。 


#6: 该 方法 在 原 有 的 基础 上 添加 了 搜索 正确 的 工具 以 具 此 来 改变 颜色 。 然 而 ， 所 写 
的 代码 的 问题 是 ， 通 过 菜单 项 使 画笔 颜色 改变 了 ， 但 是 工具 栏 上 的 单 选 工具 的 状态 
没有 相应 改变 ， 反 过 来 也 是 一 样 。 


工具 栏 中 的 工具 在 鼠标 右键 散 击 时 能 够 产生 wx.EVT TOOL RCLICKED 类 型 事件 。 
工具 栏 也 有 一 些 不 同 的 样式 ， 它 们 被 作为 位 图 参数 传递 给 CreateToolBar() 。 表 
6.4 列 出 了 一 些 工 具 栏 的 样式 。 


表 6.4 wx.ToolBar 类 的 样式 

wx.TB 3DBUTTONS : 3D 外 观 

wx.TB HORIZONTAL : 默认 样式 ， 工 具 栏 水 平 布置 
wx.TB NOICONS : 不 为 每 个 工具 显示 位 图 

wx.TB TEXT : 根据 不 同 的 位 图 显示 简短 的 帮助 文本 
wx.TB VERTICAL : 垂直 放置 工具 栏 

工具 栏 比 状态 栏 更 复杂 。 表 6.5 显 示 了 其 常用 的 一 些 方法 。 
表 6.5 wx.ToolBar 的 常用 方法 


AddControl(control) : 添加 一 个 任意 的 wxPython 控件 到 工具 栏 。 相 关 方 
法 InsertControl() ° 


AddSeparator() :在 工具 之 间 放 置 空格 。 


AddSimpleTool(id , 

bitmap , shortHelpString ="", kind = wx.ITEM NORMAL) : 添加 一 个 简单 的 
带 有 给 定位 图 的 工具 到 工具 栏 。 shortHelpString 作为 提示 显示 。 kind 的 值 可 
以 是 wx.ITEM NORMAL , wx.ITEM CHECKBOX ,或 wx.ITEM RADIO ° 


AddTool(id , 
bitmap , bitmap2 = wx.NullBitmap , kind = wx.ITEM NORMAL , shortHelpS 
=""" longHelpString ="", clientData = None) : 简单 工具 的 其 它 参 


Zt bitmap2 是 当 该 工具 被 按 下 时 所 显示 的 位 图 。 longHelpString 是 当 指 针 位 
于 该 工具 中 时 显示 在 状态 栏 中 的 帮助 字符 串 。 clientData 用 于 将 任意 的 一 块 数 
据 与 工具 相 联系 起 来 。 相 关 方 法 InsertTool() ° 


AddCheckTool(...) : 添加 一 个 复 选 框 切换 工具 ， 所 要 求 参 数 同 AddTool() ° 


By ae .) :添加 一 个 单 选 切换 工具 ， 所 要 求 参数 同 AddTool() ° X 
续 的 未 分 > TA LI LRA m. 


DeleteTool(toolId) DeleteToolByPosition(x , y) :删除 所 给 定 
的 id 的 工具 ， 或 删除 给 定 显 示 位 置 的 工具 。 


FindControl(toolId)  FindToolForPosition(x , y) :查找 并 返回 给 
定 id 或 显示 位 置 的 工具 。 


ToggleTool(toolId , toggle) : 根据 布尔 什 toggle 来 设置 给 定 id 的 工具 
的 状态 。 


下 一 节 ， 我 们 将 给 你 展示 如 何 使 用 通用 对 话 框 来 得 到 用 户 的 信息 。 


得 到 标准 信息 


你 的 应 用 程序 经 常 "nu T en 导 到 基本 的 信息 ， 这 通常 通过 对 话 框 。 在 这 
Y? ATE A atte 准 用 户 信 息 的 标准 文件 和 颜色 对 话 框 。 


如 何 使 用 标准 文件 对 话 框 ? 


部 分 的 GUI 应 用 程序 都 要 保存 和 载 入 这 样 那样 的 数据 。 考 虑 到 你 和 你 的 用 户 ， 
应 该 有 一 个 简单 的 ， 方 便 的 机 制 来 选择 文件 。 很 高 兴 ， ' 为 此 wxPython 提供 了 标准 
的 文件 对 话 框 wx.FileDialog 。 图 6.5 显 示 了 这 个 用 于 sketch 程序 的 文件 对 话 
框 。 


Open sketch file... x 





Lookin: | (C) Bels iv] o mc: Gav 
1 C3.xvpics 
| £ BCs 
VY E test. sketch 
My Recent 
Documents 
| 
Desktop 
My Documents 
- File name | iv] Open 
» , Files of type. | Sketch fies (" sketch) [v] Cancel Figure 6.5 
My Computer [_]Open as read-only A standard file 


dialog for Windows 
wx.FileDialog 最 重要 的 方法 是 它 的 构造 器 ， 语 法 如 下 : 


wx.FileDialog(parent , message =" Choose a file ", defaultDir ="", 
defaultFile ="", wildcard =".", style =0) 


表 6.6 对 构造 器 的 参数 进行 了 说 明 。 
表 6.6 wx.FileDialog 构造 器 的 参数 
parent : 对 话 框 的 父 窗口 。 如 果 没 有 父 窗口 则 为 None 。 
message : message 显示 在 对 话 框 的 标题 栏 中 。 
defaultDir : 当 对 话 框 打开 时 ， 上 默认 的 目录 。 如 果 为 空 ， 则 为 当前 工作 目录 。 


defaultFile : 当 对 话 框 打开 时 ， 上 默认 选择 的 文件 。 如 果 为 空 ， 则 没有 文件 被 选 
择 。 


wildcard : 通配符 。 指 定 要 选择 的 文件 类 型 。 格 式 是 display | wildcard 
。 可 以 指定 多 种 类 型 的 文件 ， 例 如 :" Sketch files 
(. sketch) |. sketch | A11 files (.)| ° 


style :样式 。 见 下 表 6.7。 
表 6.7 wx.FileDialog 的 样式 


wX.CHANGE DIR : 在 用 户 选 择 了 一 个 文件 之 后 ， 当 前 工作 目录 相应 改变 到 所 选 文 
件 所 在 的 目录 。 


wx.MULTIPLE : 仅 适 用 于 打开 对 话 框 。 这 个 样式 使 得 用 户 可 以 选择 多 个 文件 。 
wx.OPEN : 这 个 样式 用 于 打开 一 个 文件 。 


wx.OVERWRITE_PROMPT : 仅 适 用 于 保存 文件 对 话 框 。 显 示 一 个 提示 信息 以 确认 是 
否 履 盖 一 个 已 存在 的 文件 。 


wx.SAVE : 这 个 样式 用 于 保存 一 个 文件 。 


要 使 用 文件 对 话 框 ， 要 对 一 个 对 话 框 实 例 调 用 ShowModal() 方法 。 这 个 方法 根据 
用 户 所 敲 击 的 对 话 框 上 的 按钮 来 返回 wx.ID OK 或 wx.ID CANCEL 。 选 择 之 后 。 
使 用 GetFilename() , GetDirectory() ,或 GetPath() 方法 来 获取 数据 。 之 
后 ， 调 用 Destroy() 销毁 对 话 框 是 一 个 好 的 观念 。 


下 例 6.6 显 了 对 SketchFrame 所 作 的 修改 以 提供 保存 和 装载 (完整 的 附 书 源码 请 到 
论坛 的 "相关 资源 "的 "教程 下 载 "中 下 载 ) 。 这 些 改变 要 求 导 入 cPickle 和 os 模 
块 。 我 们 使 用 cPickle 来 将 数据 的 列表 转换 为 可 用 于 文件 读 写 的 数据 格式 。 


例 6.6 SketchFrame 的 保存 和 装载 方法 


def _init__(self, parent): 
self.title = "Sketch Frame" 
wx.Frame.__init__(self, parent, -1, self.title,size-(800 
, 600) ) 
self.filename = "" 
self.sketch = SketchWindow(self, -1) 
self.sketch.Bind(wx.EVT_MOTION, self.OnSketchMotion) 
self .initStatusBar() 
self .createMenuBar ( ) 
self .createToolBar() 


def SaveFile(self):41 保存 文件 
if self.filename: 
data = self.sketch.GetLinesData() 
f = open(self.filename, 'w') 
cPickle.dump(data, f) 
f.close() 


def ReadFile(self):42 读 文件 
if self.filename: 
try: 
f = open(self.filename, 'r') 
data = cPickle.load(f) 
f.close() 
self.sketch.SetLinesData(data) 
except cPickle.UnpicklingError: 
wx .MessageBox("%s is not a sketch file." 
% self.filename, "oops!", 
style-wx.OK|wx.ICON EXCLAMATION) 


wildcard - "Sketch files (*.sketch)|*.sketch|All files ( 


xD aC 


def OnOpen(self, event):#3 弹出 打开 对 话 框 
dlg = wx.FileDialog(self, "Open sketch file...",os.getcw 
d(), style-wx.OPEN,wildcard-self.wildcard) 
if dlg.ShowModal() == wx.ID OK: 
self.filename - dlg.GetPath() 
self.ReadFile() 


self .SetTitle(self.title + ' -- ' + self.filenam 
e) 
dlg.Destroy() 


def OnSave(self, event):#4 保存 文件 
if not self.filename: 
self.OnSaveAs(event) 
else: 
self.SaveFile() 


def OnSaveAs(self, event):#5 弹出 保存 对 话 框 

dlg = wx.FileDialog(self, "Save sketch as...", 

os.getcwd(), 

style=wx.SAVE | wx.OVERWRITE_PROMPT, 

wildcard=self.wildcard) 

if dlg.ShowModal() == wx.ID OK: 
filename - dlg.GetPath() 

if not os.path.splitext(filename)[1]:#6 确保 文件 名 后 级 
filename = filename + '.sketch' 
self.filename = filename 
self .SaveFile() 
self .SetTitle(self.title + ' -- ' + 
self .filename) 

dlg.Destroy() 


#1: 该 方法 写 文件 数据 到 磁盘 中 ， 给 定 了 文件 名 ， 使 用 了 cPickle 模块 。 


#2 : 该 方法 使 用 cPickle 来 读 文 件 。 如 果 文 件 不 是 期 望 的 类 型 ， 则 弹出 一 个 消息 


#3 : OnOpen() 方法 使 用 wx.OPEN 样式 来 创建 一 个 对 话 框 。 通 配 符 让 用 户 可 以 限 
ZAI. sketch LH » de RAP RH OK ， 那 么 该 方法 根据 所 选择 的 路 径 调 
用 ReadFile() 方法 。 


#4 : 如 果 已 经 选择 了 用 于 保存 当前 数据 的 文件 名 ， 那 么 保存 文件 ， 否 则 ， 我 们 打开 
保存 对 话 框 。 


#5 : OnSave() 方法 创建 一 个 wx.SAVE 文件 对 话 框 。 

#6 : 这 行 确 保 文 件 名 后 组 为 . sketch » 

下 一 节 ， 我 们 将 讨论 如 何 使 用 文件 选择 器 。 

如 何 使 用 标准 的 颜色 选择 器 ? 

如 果 用 户 能 够 在 sketch 对 话 框 中 选择 任意 的 颜色 ， 那 么 这 将 是 有 用 。 对 于 这 个 目 


的 ， 我 们 可 以 使 用 wxPython 提供 的 标准 wx.ColourDialog 。 这 个 对 话 框 的 用 法 
类 似 于 文件 对 话 框 。 它 的 构造 器 只 需要 一 个 parent( 双亲 ) 和 一 个 可 选 的 数据 属性 


参数 。 数 据 属性 是 一 个 wx.ColourData 的 实例 ， 它 存储 与 该 对 话 框 相关 的 一 些 数 
据 ， 如 用 户 选 择 的 颜色 ， 还 有 自 定 义 的 颜色 的 列表 。 使 用 数据 属性 使 你 能 够 在 以 后 
的 应 用 中 保持 自 定义 颜色 的 一 致 性 。 


在 sketch 应 用 程序 中 使 用 颜色 对 话 框 ， 要 求 增 加 一 个 菜单 项 和 一 个 处 理 器 方法 。 
例 6.7 显 示 了 所 增加 的 代码 。 


例 6.7 对 SketchFrame 做 一 些 改变 ， 以 显示 颜色 对 话 框 


def menuData(self): 


return [(" ", 
(" ", "New Sketch file", self.OnNew), 
(" ", "Open sketch file", self.OnOpen), 
(" ", "Save sketch file", self.OnSave), 
Cue Ag NS Eee 
i o ( 
(" ", "", self.OnColor,wx.ITEM RADIO), 
(" ", "", self.OnColor,wx.ITEM RADIO), 
(" ", "", self.OnColor,wx.ITEM RADIO), 
(" ", "", self.OnColor,wx.ITEM RADIO), 
"on, "", self.OnOtherColor,wx.ITEM_RADIO))), 
EES ue n" 


(" ", "Quit", self.OnCloseWwindow)))] 


def OnOtherColor(self, event): 
dlg - wx.ColourDialog(self) 
dlg.GetColourData().SetChooseFull(True)Z 创建 颜色 数据 对 象 
if dlg.ShowModal() == wx.ID_OK: 
self .sketch.SetColor(dlg.GetColourData().GetColo 
ur())4 根据 用 户 的 输入 设置 颜色 
dlg.Destroy() 


颜色 数据 实例 的 SetchooseFull() 方法 告诉 对 话 框 去 显示 整个 调 色 板 ， 其 中 包括 
了 自 定 义 的 颜色 信息 。 对 话 框 关闭 后 ， 我 们 根据 得 到 的 颜色 来 捡 取 颜 色 数 据 。 颜 色 
数据 作为 一 个 wx.Color 的 实例 返回 并 传递 给 sketch 程序 来 设置 颜色 。 


给 应 用 程序 一 个 好 看 的 外 观 


在 这 一 节 中 ， 我 们 将 讨论 如 何 让 你 的 程序 有 一 个 好 的 外 观 。 从 重要 性 来 说 ， 储 如 你 
如 何 作 安排 以 便 用 户 调整 窗口 的 大 小 ， 从 细节 来 说 ， 储 如 你 如 何 显示 一 
个 about 框 。 在 本 书 的 第 二 部 分 ， 我 们 将 更 详细 地 对 这 些 主 题 进 行进 一 步 的 讨 


论 。 
如 何 布局 窗口 部 件 ? 
在 你 的 wxPython 应 用 程序 中 布局 你 的 窗口 部 件 的 方法 之 一 是 ， 在 每 个 窗口 部 件 被 


创建 时 显 式 地 指定 它 的 位 置 和 大 小 。 虽 然 这 个 方法 相当 地 简单 ， 但 是 它 一 直 存 在 几 
个 缺点 。 其 中 之 一 就 是 ， 因 为 窗口 部 件 的 尺寸 和 默认 字体 的 尺寸 不 同 ， 对 于 在 所 有 


系统 上 要 得 到 一 个 正确 的 定位 是 非常 困难 的 。 另 外 ， 每 当 用 户 调整 父 窗口 的 大 小 
时 ， 你 必须 显 式 地 改变 每 个 窗口 部 件 的 定位 ， 要 正确 地 实现 它 是 十 分 痛苦 的 。 


幸运 的 是 ， 这 儿 有 一 个 更 好 的 方法 。 在 wxPython 中 的 布局 机 制 是 一 个 被 称 

为 sizer 的 东西 ， 它 类 似 于 Java Aw 和 其 它 的 界面 工具 包 中 的 布局 管理 器 。 
每 个 不 同 的 sizer 基于 一 套 规则 管理 它 的 窗口 的 尺寸 和 位 置 。 sizer 属于 一 个 
容器 窗口 (比如 wx.Panel ) 。 在 父 中 创建 的 子 窗口 必须 被 添加 

给 sizer > sizer 管理 每 个 窗口 部 件 的 尺寸 和 位 置 。 


创建 一 个 sizer 
创建 一 个 sizer 的 步骤 : 


1、 创 建 你 想 用 来 自动 调用 尺寸 的 panel 或 container( 容器 )。2、 创 

Æ sizer 。3、 创 建 你 的 子 窗口 。4、 使 用 sizer 的 Add() 方法 来 将 每 个 子 窗 
口 添加 给 sizer 。 当 你 添加 窗口 和 时， 给 了 sizer 附加 的 信息 ， 这 包括 窗口 周围 
空间 的 度量 、 在 由 sizer 所 管理 分 配 的 空间 中 如 何 对 齐 窗口 、 当 容器 窗口 改变 大 
小 时 如 何 扩 展 子 窗口 等 。5、 sizer 可 以 诅 套 ， 这 意味 你 可 以 像 窗口 对 象 一 样 添 
加 别 的 sizer 到 父 sizer 。 你 也 可 以 预 留 一 定数 量 的 空间 作为 分 隔 。6、 调 用 容 
#4) SetSizer(sizer) 方法 。 


表 6.8 列 出 了 在 wxPython 中 有 效 的 最 常用 的 sizer 。 对 于 每 个 专门 的 sizer 的 
更 完整 的 说 明 见 第 11 章 。 


表 6.8 最 常用 的 wxPython 的 sizer 


wx.BoxSizer :在 一 条 线 上 布局 子 窗 口 部 件 。 wx.BoxSizer 的 布局 方向 可 以 是 
水 平 或 坚 直 的 ， 并 且 可 以 在 水 平 或 坚 直 方向 上 包含 子 sizer 以 创建 复杂 的 布局 。 
在 项 目 被 添加 时 传递 给 sizer 的 参数 控制 子 窗口 部 件 如 何 根 据 box MEARE 
直 轴 线 作 相应 的 尺寸 调整 。 


wx.FlexGridSizer :一 个 固定 的 二 维 网 格 ， 它 与 wx.GridSizer 的 区 别 是 ， 行 
和 列 根 据 所 在 行 或 列 的 最 大 元 素 分 别 被 设置 。 


wx.GridSizer :一 个 固定 的 二 维 网 格 ， 其 中 的 每 个 元 素 都 有 相同 的 尺寸 。 当 创 
建 一 个 grid sizer 时 ， 你 要 么 固定 行 的 数量 ， 要 么 固定 列 的 数量 。 项 目 被 从 左 
到 右 的 添加 ， 直 到 一 行 被 十 满 ， 然 后 从 下 一 行 开 始 。 


wx.GridBagSizer : 一 个 国定 的 二 维 网 格 ， 基 于 wx.FlexGridSizer 。 人 允许 项 
目 被 放置 在 网 格 上 的 特定 点 ， 也 允许 项 目 跨 越 多 和 网 格 区 域 。 


wx.StaticBoxSizer :等 同 于 wx.BoxSizer ， 只 是 在 box 周围 多 了 一 个 附加 
的 边框 (有 一 个 可 选 的 标签 ) 。 


使 用 sizer 


为 了 演示 sizer 的 用 法 ， 我 们 将 给 sketch 应 用 程序 增加 一 个 control 

panel ° control panel 包含 用 来 设置 线条 颜色 和 粗细 的 按钮 。 这 个 例子 使 
用 了 wx.Gridsizer (用 于 按钮 ) 和 wx.BoxSizer (用 于 其 余 的 布局 部 分 ) 。 图 
6.6 显 示 了 使 用 了 panel 的 sketch 应 用 程序 ， 并 图 解 了 grid 和 box 的 实际 布 
Bs 
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Figure 6.6 The Sketch application with an automatically laid out control panel 


例 6.8 显 示 了 实现 control panel 而 对 sketch 程序 所 作 的 必要 的 改变 。 在 这 
一 节 ， 我 们 的 讨论 将 着 重 于 sizer 的 实现 。 


例 6.8 


def _init__(self, parent): 
self.title = "Sketch Frame" 


wx.Frame. init (self, parent, -1, self.title, size-(80 
0,600)) 


self.filename = "" 

self.sketch = SketchWindow(self, -1) 
self.sketch.Bind(wx.EVT_MOTION, self.OnSketchMotion) 
self .initStatusBar() 

self .createMenuBar ( ) 

self.createToolBar() 

self.createPanel() 


def createPanel(self): 
controlPanel - ControlPanel(self, -1, self.sketch) 
box - wx.BoxSizer(wx.HORIZONTAL) 
box.Add(controlPanel, 0, wx.EXPAND) 
box.Add(self.sketch, 1, wx.EXPAND) 
self.SetSizer(box) 


916.87 > createPanel() 方法 创建 了 ControlPanel (在 下 面 的 列表 中 说 
8H) 的 实例 ， 并 且 与 box sizer 放 在 一 起 。 wx.BoxSizer 的 构造 器 的 唯一 参 
数 是 方向 ， 取 值 可 以 是 wx.HORIZONTAL 或 wx.VERTICAL 。 接 下 来 ， 这 个 新 


的 controlPanel 和 先前 创建 的 Sketchwindow 被 使 用 Add() 方法 添加 给 

了 sizer 。 第 一 个 参数 是 要 被 添加 给 sizer 的 对 象 。 第 二 个 参数 是 

被 wx.BoxSizer 用 作 因 数 去 决定 当 sizer 的 大 小 改变 时 ， sizer 应 该 如 何 调整 
它 的 孩子 的 尺寸 。 我 们 这 里 使 用 的 是 水 平方 向 调整 的 sizer ， stretch 因数 决 
定 每 个 孩子 的 水 平 尺 寸 如 何 改变 ( 坚 直 方向 的 改变 由 box sizer 基于 第 三 个 参 
数 来 决定 ) 。 

如 果 第 二 个 参数 ( stretch AR) 是 0， 对 象 将 不 改变 尺寸 ， 无 论 sizer 如 何 变 
化 。 如 果 第 二 个 参数 大 于 0， 则 sizer 中 的 孩子 根据 因数 分 割 sizer 的 总 尺寸 
(类 似 于 wx.StatusBar 管理 文本 域 的 宽度 的 做 法 ) 。 如 果 sizer 中 的 所 有 和 孩子 
有 相同 的 因数 ， 那 么 它们 按 相 同 的 比例 分 享 放 置 了 固定 尺寸 的 元 素 后 剩 下 的 空间 。 
这 里 的 0 表示 假如 用 户 伸 展 框架 时 ， controlPanel 不 改变 水 平 的 尺寸 ， 而 1 表示 
绘画 窗口 ( sketch window ) 的 尺寸 要 随 框架 的 改变 而 改变 。 


Add() 的 第 三 个 参数 是 另 一 个 位 掩 码 标志 。 完整 的 说 明 将 在 以 后 的 章节 中 给 

Hi^ wx.EXPAND 指示 sizer 调整 孩子 的 大 小 以 完全 填 满 有 效 的 空间 。 其 它 的 可 
能 的 选项 允许 孩子 被 按 比 例 的 调整 尺寸 或 根据 sizer 的 特定 部 分 对 齐 。 图 6.7 将 帮 
助 阐明 参数 及 其 控制 的 调整 尺寸 的 方向 。 

这 些 设置 的 结果 是 当 你 运行 这 个 带 有 box sizer 的 框架 的 时 候 ， 任 何在 水 平方 
向 的 改变 都 将 导致 sketch window 的 尺寸 在 该 方向 ? 系 母 谋 测 焉 panel 不 会 在 
该 方向 上 改变 。 在 坚 直 方向 的 尺寸 改变 导致 这 两 个 子 窗口 都 要 在 坚 直方 向 缩放 。 

例 6.8 中 涉及 的 类 ControlPanel 结合 使 用 了 grid 和 box sizer 。 例 6.9 包 含 
了 这 个 类 的 代码 。 
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Figure 6.7 A drawing showing which argument determines resize behavior in each direction. 


例 6.9 ControlPanel 类 


class ControlPanel(wx.Panel): 


BMP_SIZE = 16 
BMP_BORDER = 3 
NUM_COLS = 4 
SPACING = 4 


colorList = ('Black', 'Yellow', 'Red', 'Green', 'Blue', 'Pur 


ple', 


1 
, 


'Brown', 'Aquamarine', 'Forest Green', 'Light Blue 
'Goldenrod', 'Cyan', 'Orange', 'Navy', 'Dark Grey' 


'Light Grey') 


maxThickness - 16 


def 


ER) 


def 


p-2) 


.— init (self, parent, ID, sketch): 
wx.Panel. init (self, parent, ID, style-wx.RAISED BORD 


self.sketch - sketch 

buttonSize = (self.BMP SIZE + 2 * self.BMP BORDER, 
Self.BMP SIZE + 2 * self.BMP BORDER) 

colorGrid - self.createColorGrid(parent, buttonSize) 

thicknessGrid - self.createThicknessGrid(buttonSize) 

self.layout(colorGrid, thicknessGrid) 


createColorGrid(self, parent, buttonSize):#1 创建 颜色 网 格 
self.colorMap = {} 

self.colorButtons = {} 

colorGrid = wx.GridSizer(cols-self.NUM COLS, hgap=2, vga 


for eachColor in self.colorList: 
bmp = parent .MakeBitmap(eachColor ) 
b = buttons.GenBitmapToggleButton(self, -1, bmp, siz 


e-buttonSize) 


def 


vgap-2) 


b.SetBezelwidth(1) 

b.SetUseFocusIndicator (False) 

self.Bind(wx.EVT BUTTON, self.OnSetColour, b) 

colorGrid.Add(b, 0) 

self.colorMap[b.GetId()] = eachColor 

self.colorButtons[eachColor] = b 
self.colorButtons[self.colorList[0]].SetToggle(True) 
return colorGrid 


createThicknessGrid(self, buttonSize):42 创建 线条 粗细 网 格 
self.thicknessIdMap = {} 

self.thicknessButtons = {} 

thicknessGrid = wx.GridSizer(cols=self.NUM_COLS, hgap=2, 


for x in range(1, self.maxThickness + 1): 
b - buttons.GenToggleButton(self, -1, str(x), size-b 


uttonSize) 


b.SetBezelwidth(1) 
b.SetUseFocusIndicator (False) 


self.Bind(wx.EVT BUTTON, self.OnSetThickness, b) 
thicknessGrid.Add(b, 0) 
self.thicknessIdMap[b.GetId()] = x 
self.thicknessButtons[x] = b 

self .thicknessButtons[1].SetToggle(True) 

return thicknessGrid 


def layout(self, colorGrid, thicknessGrid):43 合并 网 格 
box - wx.BoxSizer(wx.VERTICAL) 
box.Add(colorGrid, ©, wx.ALL, self.SPACING) 
box.Add(thicknessGrid, 0, wx.ALL, self.SPACING) 
self.SetSizer(box) 
box.Fit(self) 


def OnSetColour(self, event): 
color - self.colorMap[event.GetId()] 
if color !- self.sketch.color: 
self.colorButtons[self.sketch.color].SetToggle(False 


) 
self.sketch.SetColor(color) 
def OnSetThickness(self, event): 
thickness - self.thicknessIdMap[event.GetId()] 
if thickness !- self.sketch.thickness: 
self.thicknessButtons[self.sketch.thickness].SetTogg 
le(False) 


self.sketch.SetThickness(thickness) 


#1: createColorcrid() 方法 建造 包含 颜色 按钮 的 grid sizer 。 首 先 ， 我 
们 创建 sizer 本 身 ， 指 定 列 为 4 列 。 由 于 列 数 已 被 设 定 ， 所 以 按钮 将 被 从 左 到 右 的 
布局 ， 然 后 向 下 。 接 下 来 我 们 要 求 颜 色 的 列表 ， 并 为 每 种 颜色 创建 一 个 按钮 。 

在 for 循环 中 ， 我 们 为 每 种 颜色 创建 了 一 个 方形 的 位 图 ， 并 使 用 wxPython 库 中 
所 定义 的 一 般 的 按钮 窗口 部 件 类 创建 了 带 有 位 图 的 切换 按钮 。 然 后 我 们 把 按钮 与 事 
件 相 绑 定 ， 并 把 它 添加 到 grid 。 之 后 ， 我 们 把 它 添加 到 字典 以 便 在 以 后 的 代码 
中 ， 易 于 关联 颜色 、 ID 和 和 按钮。 我 们 不 必 指 定 按钮 在 网 格 中 的 位 置 ; sizer 将 
为 我 们 做 这 件 事 。 


#2: createThicknessGrid() 方法 基本 上 类 似 于 createColorGrid() 方法 。 
实际 上 ， 一 个 有 进取 心 的 程序 员 可 以 把 它们 做 成 一 个 通用 函数 。 grid sizer 被 
创建 ， 十 六 个 按钮 被 一 次 性 添加 ， sizer 确保 了 它们 在 屏幕 上 很 好 地 排列 。 


#3 : 我 们 使 用 一 个 坚 直 的 box sizer 来 放置 网 格 ( grid) 。 每 个 grid 的 第 二 
个 参数 都 是 0， 这 表明 grid sizer 4 control panel 在 垂直 方向 伸展 时 不 

改变 尺寸 。 (由 于 我 们 已 经 知道 control panel 不 在 水 平方 向 改变 尺寸 ， 所 以 
我 们 不 必 指 定 水 平方 向 的 行为 。) Add() 的 第 四 个 参数 是 项 目的 边框 宽度 ， 这 里 
使 用 self.sPACING 变量 指定 。 第 三 个 参数 wx.ALL 是 一 套 标志 中 的 一 个 ， 它 控 

制 那些 边 套 用 第 四 个 参数 指定 的 边框 宽度 ， wx. ALL 表明 对 象 的 四 个 边 都 套用 。 最 
后 ， 我 们 调用 box sizer 的 Fit() 方法 ， 使 用 的 参数 是 control panel ° 


这 个 方法 告诉 control panel 调整 自身 尺寸 以 匹配 sizer 认为 所 需要 的 最 小 
化 尺寸 。 通 常 这 个 方法 在 使 用 了 sizer 的 窗口 的 构造 中 被 调用 ， 以 确保 窗口 的 大 
小 足以 包含 sizer 。 


基 类 wx.Sizer 包含 了 几 个 通用 于 所 有 sizer 的 方法 。 表 6.9 列 出 了 最 常用 的 方 
法 。 


表 6.9 wx.Sizer 的 方法 


Add(window, proportion=0, 
flag-0, border=0, 
userData=None) 


Add(sizer, proportion=0, 
flag-0, border=0, 
userData=None) 


Add(size , proportion =0, flag =0, border =0, userData = None) :第 
一 个 添加 一 个 wxwindow > >^ mik E sizer ， 第 三 个 添加 空 的 空 
la] > VED WAH © BAK proportion 管理 窗口 总 尺寸 ， 它 是 相对 于 别 的 窗口 的 改 
变 而 言 的 ， 它 只 对 wx.BoxSizer 有 意义 。 参 数 flag 是 一 个 位 图 ， 针 对 对 齐 、 边 
框 位 置 ， 增 长 有 许多 不 同 的 标志 ， 完 整 的 列表 见 第 十 一 章 。 参 数 border 是 窗口 
或 sizer 周围 以 像素 为 单位 的 空间 总 量 。 userData 使 你 能 够 将 对 象 与 数据 关 
联 ， 例 如 ， 在 一 个 子 类 中 ， 可 能 需要 更 多 的 用 于 尺寸 的 信息 。 


Fit(window)  FitInside(window ): 调整 window 尺寸 以 匹配 sizer 认为 
所 需要 的 最 小 化 尺寸 。 这 个 参数 的 值 通常 是 使 用 sizer 的 窗 

We FitInside() 是 一 个 类 似 的 方法 ， 只 不 过 将 改变 窗口 在 屏幕 上 的 显示 替换 为 
只 改变 它 的 内 部 实现 。 它 用 于 scroll panel 中 的 窗口 以 触发 滚动 栏 的 显示 。 


GetSize() : 以 wx.Size 对 象 的 形式 返回 sizer 的 尺寸 。 
GetPosition() :以 wx.Point 对 象 的 形式 返回 sizer 的 位 置 。 


GetMinSize() : 以 wx.Size 对 象 的 形式 返回 完全 填充 sizer 所 需 的 最 小 尺 
Es 


Layout() : 强迫 sizer 去 重新 计算 它 的 孩子 的 尺寸 和 位 置 。 在 动态 地 添加 或 删 
除了 一 个 孩子 之 后 调用 。 


Prepend(...) : 5 Add() 相同 (只 是 为 了 布局 的 目的 ， 把 新 的 对 象 放 
在 sizer 列表 的 开头 ) © 


Remove(window) Remove(sizer)  Remove(nth) :从 sizer 中 删除 一 个 对 
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SetDimension(x , y, width , height) : 强迫 sizer 按照 给 定 的 参数 重新 定 
位 它 的 所 有 和 孩子 。 


AK sizer FRA sizer 的 更 详细 的 信息 请 参考 第 11 章 。 


如 何 建 造 一 个 关于 (about) 框 ? 


about 框 是 显示 对 话 框 的 一 个 好 的 例子 ， 它 能 够 显示 比 纯 信 息 框 更 复杂 的 信息 。 

这 里 ， 你 可 以 使 用 wx.html.Htmlwindow 作为 一 个 简单 的 机 制 来 显示 样式 文本 。 
实际 上 ， wx.html.Htmlwindow 远 比 我 们 这 里 演示 的 强大 ， 它 包括 了 管理 用 户 交 
互 以 及 绘制 的 方法 。 第 16 章 涵盖 了 wx .html.,Htmlwindow 的 特性 。 例 6.10 展 示 了 
一 个 类 ， 它 使 用 HTML renderer 创建 一 个 about 框 。 


例 6.10 4$ wx.html.HtmlWindow 作为 一 个 about 框 


class SketchAbout(wx.Dialog): 
text - ''' 
<html> 
<body bgcolor="#ACAA60"> 
<center><table bgcolor="#455481" width="100%" cellspacing="0" 
cellpadding="0" border="1"> 
<tr> 
«td align="center"><h1>Sketch!</h1i></td> 
</tr> 
</table> 
</center> 
<p><b>Sketch</b> is a demonstration program for 
<b>wxPython In Action</b> 
Chapter 6\. It is based on the SuperDoodle demo included 
with wxPython, available at http://www.wxpython.org/ 
</p> 
<p><b>SuperDoodle</b> and <b>wxPython</b> are brought to you by 
<b>Robin Dunn</b> and <b>Total Control Software</b>, Copyright 
&copy; 1997-2006.</p> 
</body> 
«/html»s 


def _ init (self, parent): 
wx.Dialog. init (self, parent, -1, 'About Sketch', 
size-(440, 400) ) 


html = wx.html.Htmlwindow(self) 
html.SetPage(self.text) 
button - wx.Button(self, wx.ID OK, "Okay") 


sizer - wx.BoxSizer(wx.VERTICAL) 
sizer.Add(html, 1, wx.EXPAND|wx.ALL, 5) 
sizer.Add(button, 0, wx.ALIGN_CENTER|wx.ALL, 5) 


self.SetSizer(sizer) 
self.Layout() 


第 六 章 使 用 wxPython 基 本 构件 


上 面 的 HTML 字符 串 中 ， 有 一 些 布局 和 字体 标记 。 这 里 的 对 话 框 合并 
了 wx.html.Htmlwindow 和 一 个 wx.ID OK ID 按钮 。 敲 击 按钮 则 自动 关闭 窗 
口 ， 如 同 其 它 对 话 框 一 样 。 一 个 垂直 的 box sizer 用 于 管理 这 个 布局 。 


图 6.8 显 示 了 该 对 话 框 。 图 6.8 
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Figure 6.8 
The HTML about box 





把 它 作 为 一 个 菜单 项 ( About) 的 处 理 器 的 方法 如 下 : 


def OnAbout(self, event): 
dlg = SketchAbout(self) 
dlg.ShowModal() 
dlg.Destroy() 


如 何 建造 一 个 司 动画 面 ? 


显示 一 个 好 的 启动 画面 ， 将 给 你 的 用 户 一 种 专业 化 的 感觉 。 在 你 的 应 用 程序 完成 一 
个 费时 的 设置 的 时 候 ， 它 也 可 以 转移 用 户 的 注意 力 。 在 wxPython 中 ， 使 用 
X wx.SplashScreen 建造 一 个 启动 画面 是 很 容易 的 。 启 动画 面 可 以 保持 显示 指定 
的 时 间 ， 并 且 无 论 时 间 是 否 被 设置 ， 当 用 户 在 其 上 敲 击 时 ， 它 总 是 会 关闭 。 


wx.SplashScreen 类 的 构造 函数 如 下 : 
wx.SplashScreen(bitmap, splashStyle, milliseconds, parent, id, 
pos=wx.DefaultPosition, size=wx.DefaultSize, 
style=wx.SIMPLE_BORDER|wx.FRAME_NO_TASKBAR | wx.STAY_ON_TO 
P) 
表 6.10 说 明了 wx.SplashScreen 构造 函数 的 参数 


表 6.10 wx.SplashScreen 构造 函数 的 参数 
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bitmap : 一 个 wx.Bitmap ， 它 被 显示 在 屏幕 上 。 


splashStyle : 另 一 个 位 图 样式 ， 可 以 是 下 列 的 结 
es WX.SPLASH CENTRE ON PARENT , wx.SPLASH CENTRE ON SCREEN , 


WX.SPLASH NO CENTRE , wx.SPLASH TIMEOUT , wx.SPLASH NO TIMEOUT 


milliseconds : 如 果 splashStyle 指定 
A wx.SPLASH TIMEOUT ^ milliseconds 是 保持 显示 的 毫秒 数 。 


parent : 父 窗 口 ， 通 常 为 None ° 
id :窗口 ID ， 通 常 使 用 -1 比较 好 。 


pos : 如果 splashStyle 取 值 wx.SPLASH NO CENTER 的 话 ， pos 指定 画面 
在 屏幕 上 的 位 置 。 


size : 尺寸 。 通 常 你 不 需要 指定 这 个 参数 ， 因 为 通常 使 用 位 图 的 尺寸 。 
style : 常规 的 wxPython 框架 的 样式 ， 一 般 使 用 默认 值 就 可 以 了 。 


例 6.11 显 示 了 启动 画面 的 代码 。 这 里 我 们 用 一 具 自 定义 的 wx.App 子 类 来 替代 
了 wx.PySimpleApp ° 


例 6.11 一 个 局 动画 面 的 代码 


class SketchApp(wx.App): 


def OnInit(self): 
bmp = wx.Image("splash.png").ConvertToBitmap() 


wx.SplashScreen(bmp, wx.SPLASH_CENTRE_ON_SCREEN | wx.SPL 
ASH_TIMEOUT, 


1000, None, -1) 
wx.Yield() 


frame = SketchFrame(None) 
frame.Show(True) 

self .SetTopwindow( frame) 
return True 


通常 ， 启 动画 面 被 声明 在 应 用 程序 启动 期 间 的 OnInit 方法 中 。 启 动画 面 将 一 直 显 
示 直 到 它 被 敲 击 或 超时 。 这 里 ， 局 动画 面 显示 在 屏幕 的 中 央 ， 一 秒 后 超 

时 。 Yield() 的 调用 很 重要 ， 因 为 它 使 得 在 应 用 程序 继续 局 动 前 ， 任 何 未 被 处 理 
的 事件 仍 可 以 被 继续 处 理 。 这 里 ， Yield() 的 调用 确保 了 在 应 用 程序 继续 启动 

前 ， 启 动画 面 能 够 接受 并 处 理 它 的 初始 化 绘制 事件 。 


1. 大 多 数 的 应 用 程序 使 用 了 诸如 菜单 、 工 具 栏 和 局 动画 面 这 样 的 通常 的 元 素 。 它 
们 的 使 用 不 但 对 你 程序 的 可 用 性 有 帮助 ， 并 且 使 你 的 应 用 程序 看 起 来 更 专业 。 
在 这 一 章 里 ， 我 们 使 用 了 一 个 简单 的 sketch 应 用 程序 ， 并 且 使 用 了 工具 栏 、 
状态 栏 、 菜 单 栏 ， 通 用 对 话 框 、 复 杂 的 布局 、 about 框 和 局 动画 面 来 逐步 对 
它 作 了 改进 。 


2. 你 可 以 使 用 一 个 设备 上 下 文 来 直接 对 wxPython 的 显示 进行 绘制 。 不 同 的 显示 
要 求 不 同 的 设备 上 下 文 ， 然 而 它们 共享 一 个 通用 API 。 为 了 平滑 的 显示 ， 设 
备 上 下 文 可 以 被 缓存 。 


3. 一 个 状态 栏 能 够 被 自动 地 创建 在 框架 的 底部 。 它 可 以 包含 一 个 或 多 个 文本 域 ， 
各 文本 域 可 被 独立 调整 尺寸 和 设置 。 


4. 菜单 可 以 包含 谋 套 的 子 菜 单 ， 菜 单项 可 以 有 切换 状态 。 工 具 栏 产生 与 菜单 栏 同 
种 的 事件 ， 并 且 被 设计 来 更 易于 对 工具 按钮 分 组 布局 。 

5. 可 以 使 用 标准 wx.FileDialog 来 管理 打开 和 保存 数据 。 可 以 使 
用 wx.ColourDialog 来 选择 颜色 。 


6. 使 用 sizer 可 以 进行 窗口 部 件 的 复杂 布局 ， 而 不 用 明确 地 指定 具体 位 

B sizer 根据 规则 自动 放置 它 的 孩子 对 象 。 sizer 包括 

的 wx.GridSizer 按 二 维 网 格 来 布局 对 象 。 wx.BoxSizer 在 一 条 线 上 布局 项 
Hoo sizer TARA’ HAY sizer 伸展 时 可 以 ， 它 可 以 控制 其 孩子 的 行 
为 o 


7. about 框 或 别 的 简单 的 对 话 框 可 以 使 用 wx.html.Htmlwindow 来 创建 。 启 动 
画面 用 wx.SplashScreen 来 创建 。 


在 第 一 部 分 ( part 1) 中 ， 我 们 已 经 涵盖 了 wxPython 的 基本 概念 ， 并 且 我 们 已 
经 涉及 了 一 些 最 常见 的 任务 。 在 接 下 来 的 第 二 部 分 ( part 2) 中 ， 我 们 将 使 用 目 
前 常见 的 问答 的 格式 ， 但 是 我 们 将 涉及 有 关 wxPython 工具 包 的 组 成 和 功能 方面 的 
更 详细 的 问题 。 


大 大 


第 二 部 分 基础 WxPython 


在 本 书 的 这 一 部 分 ， 我 们 将 浏览 基本 的 窗口 部 件 ， 它 们 组 成 了 wxPython 工具 包 的 
核心 。 它 们 是 你 写 wxPython 程序 要 用 到 的 关键 的 部 分 。 对 于 其 中 的 每 个 元 素 ， 我 
们 将 给 你 展示 关于 该 元 素 的 最 重要 的 那些 API ， 还 有 例子 代码 和 关于 如 何在 实际 
程序 中 使 用 该 元 素 的 技巧 。 


第 7 章 ，“ 使 用 基本 的 窗口 部 件 ”" 中 ， 我 们 从 基本 窗口 部 件 的 设置 开始 。 我 们 将 涉及 文 
本 标签 ， 文 本 域 ， 按 钮 、 和 数字 及 列表 选择 窗口 部 件 。 我 们 将 给 你 展示 如 何 使 用 每 
个 元 素 ， 如 何 自 定义 它们 的 外 观 以 匹配 你 的 应 用 程序 ， 以 及 如 何 去 响 应 用 户 的 交 
互 。 在 第 8 章 ，" 在 框架 中 放 入 窗口 部 件 " 中 ， 我 们 将 上 升 到 容器 级 并 谈论 框架 。 我 们 
将 给 你 展示 如 何 添加 窗口 部 件 到 框架 中 ， 并 说 明 有 效 的 框架 样式 。 我 们 也 将 涉及 框 
架 从 创建 到 销毁 的 生命 周期 。 在 第 9 章 ，*“ 使 用 对 话 框 给 用 户 选择 "中 ， 我 们 将 聚焦 于 
对 话 框 ， 以 对 话 框 与 框架 的 区 别 作 为 开始 。 我 们 也 将 展示 一 系列 在 wxPython 中 有 
效 的 预定 义 的 对 话 框 ， 以 及 方便 使 用 它们 的 捷径 。 


在 第 十 章 “ 创 建 和 使 用 wxPython 菜单 "中 ， 重 点 是 菜单 。 我 们 将 讨论 如 何 去 创 建 菜 
单项 ， 菜 单项 可 以 被 附着 到 菜单 上 ， 可 以 被 放置 到 菜单 栏 上 。 我 们 也 将 涉及 切换 菜 
€ ( toggle menus ) 、 弹 出 菜单 ， 以 及 各 种 自 定义 菜单 显示 的 方法 。 在 第 11 
章 “ 使 用 sizer 放置 窗口 部 件 " 中 ， 我 们 将 揭秘 sizer 技术 。 sizer 被 用 来 

在 wxPython 框架 和 对 话 框 中 简化 窗口 部 件 的 布局 。 我 们 将 涉及 6 种 预定 义 

的 sizer ， 给 你 展示 它们 的 行为 ， 并 给 出 关于 何 时 使 用 它们 才 最 恰当 的 一 些 提 

示 。 最 后 ， 在 第 12 章 “处 理 基本 的 图 像 "中 ， 我 们 将 讨论 经 由 设备 上 下 文 来 在 屏幕 上 
绘图 的 一 些 基础 知识 ， 我 们 列 出 了 原始 的 绘图 方法 ， 你 可 以 用 它们 来 绘制 你 自己 的 
窗口 部 件 或 支持 用 户 的 绘画 ， 或 仅 用 于 装饰 。 


3x 使 用 基础 控件 


. 使 用 基本 的 控件 工作 
i 显示 文本 
i 使 用 按钮 工作 
iii, 输入 并 显示 数字 
iv. 给 用 户 以 选择 
v. 本 章 小 结 


wxPython 工具 包 提供 了 多 种 不 同 的 窗口 部 件 ， 包 括 了 本 章 所 提 到 的 基本 控件 。 我 
们 涉及 静态 文本 、 可 编辑 的 文本 、 按 钮 、 微 调 、 滑 块 、 复 选 框 、 单 选 按 钮 ~、 选择 

器 、 列 表 框 、 组 合 框 和 标尺 。 对 于 每 种 窗口 部 件 ， 我 们 将 提供 一 个 关于 如 何 使 用 它 
的 简短 例子 ， 并 附 上 相关 的 wxPython API 的 说 明 。 


显示 文本 
这 一 节 以 在 屏幕 上 显示 文本 的 例子 作为 开始 ， 包 括 用 作 标 签 的 静态 文本 域 ， 有 样式 


和 无 样式 的 都 使 用 了 。 你 可 以 创建 用 于 用 户 输 入 的 单行 和 多 行文 本 域 。 另 外 ， 我 们 
将 讨论 如 何 选择 文本 的 字体 。 


如 何 显示 静态 文本 ? 


大 概 对 于 所 有 的 UI 工具 来 说 ， 最 基本 的 任务 就 是 在 屏幕 上 绘制 
在 wxPython 中 ， 使 用 类 wx.StaticText 来 完成 。 图 7.1 显 示 了 这 个 静态 文本 控 
件 。 
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Figure 7.1 Samples of wx. StaticText, 
including font, alignment, and color changes 


在 wx.StaticText 中 ， 你 能 够 改变 文本 的 对 齐 方式 、 字 体 和 颜色 。 简 单 的 静态 文 
本 控件 可 以 包含 多 行文 本 ， 但 是 你 不 能 处 理 多 种 字体 或 样式 。 处 理 多 种 字体 或 样 
式 ， 要 使 用 更 精细 的 文本 控件 ， 如 wx.html.HTMLWindow ， 它 在 第 十 六 章 中 说 

明 。 为 了 在 静态 文本 控件 中 显示 多 行文 本 ， 我 们 要 包括 其 中 有 换行 符 的 字符 串 ， 并 
使 控件 的 大 小 足够 显示 所 有 的 文本 。 有 一 个 特点 是 你 在 图 7.1 中 所 不 能 看 到 的 ， 那 就 
是 wx.StaticText 窗口 不 会 接受 或 响应 鼠标 事件 。 


如 何 显示 静态 文本 
例子 7.1 显 示 了 产生 图 7.1 的 代码 。 
例 7.1 如 何 使 用 静态 文本 的 一 个 基本 例子 


import wx 


class StaticTextFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, -1, 'Static Text Example', 
size-(400, 300)) 
panel - wx.Panel(self, -1) 


# 这 是 一 个 基本 的 静态 文本 
wx.StaticText(panel, -1, "This is an example of static text", 
(100, 10)) 


H 指定 了 前 景色 和 背景 色 的 静态 文本 
rev = wx.StaticText(panel, -1, "Static Text With Reversed Colors 


n 
, 


(100, 30)) 
rev.SetForegroundColour( white!) 
rev.SetBackgroundColour('black' ) 


# 指定 居中 对 齐 的 的 静态 文本 
center = wx.StaticText(panel, -1, "align center", (100, 50), 
(160, -1), wx.ALIGN_CENTER) 
center.SetForegroundColour('white' ) 
center .SetBackgroundColour('black' ) 


# 指定 右 对 齐 的 静态 文本 
right = wx.StaticText(panel, -1, "align right", (100, 70), 
(160, -1), wx.ALIGN_RIGHT) 
right .SetForegroundColour('white' ) 
right .SetBackgroundColour('black' ) 


# 指定 新 字体 的 静态 文本 
str = "You can also change the font." 
text = wx.StaticText(panel, -1, str, (20, 100)) 
font = wx.Font(18, wx.DECORATIVE, wx.ITALIC, wx.NORMAL) 
text .SetFont( font) 


# 显示 多 行文 本 
wx.StaticText(panel, -1, "Your text\ncan be split\n" 
"over multiple lines\n\neven blank ones", (20,15 


0)) 


# 显 示 对 齐 的 多 行文 本 
wx.StaticText(panel, -1, "Multi-line text\ncan also\n" 
"be right aligned\n\neven with a blank", (220,150), 
style-wx.ALIGN RIGHT) 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = StaticTextFrame() 
frame.Show() 
app.MainLoop() 


wx.StaticText 5$449i& HAF KAN wxwidget HW HRM > dw TP : 


wx.StaticText(parent, id, label, pos=wx.DefaultPosition, 
size-wx.DefaultSize, style-0, name="staticText") 


表 7.1 说 明了 这 些 参 数 
构造 函数 的 参数 的 更 详细 的 说 明 ， 请 参见 第 2 章 的 相关 论述 。 


表 7.1 wx.StaticText 构造 函数 的 参数 





parent : 父 窗口 部 件 。 
id : 标识 符 。 使 用 -1 可 以 自动 创建 一 个 唯一 的 标识 。 
label : 你 想 显 示 在 静态 控件 中 的 文本 。 
pos :一 个 wx.Point 或 一 个 Python 元 组 ， 它 是 窗口 部 件 的 位 置 。 
size :一 个 wx.Size 或 一 个 Python 元 组 ， 它 是 窗口 部 件 的 尺寸 。 
style :样式 标记 。 
name : 对 象 的 名 字 ， 用 于 查找 的 需要 。 
接 下 来 我 们 更 详细 地 讨论 样式 标记 。 
使 用 样式 工作 


所 有 在 例 7.1 中 静态 文本 实例 所 调用 的 方法 都 是 属于 基 父 
类 wx.window 的 ; wx.StaticText 没有 定义 任何 它 自己 的 新 方法 。 表 7.2 列 
一 些 专用 于 wx.StaticText 的 样式 。 


表 7.2 
wX.ALIGN CENTER : 静态 文本 位 于 静态 文本 控件 的 中 心 。 
WX.ALIGN LEFT :文本 在 窗口 部 件 中 左 对 齐 。 这 是 默认 的 样式 。 


wx.ALIGN_RIGHT :文本 在 窗口 部 件 中 右 对 齐 。 


大 多 数 的 PRY OL 窗口 部 件 都 有 相 类 似 的 参数 。 对 于 


出 了 


wx.ST_NO_AUTORESIZE : 如 果 使 用 了 这 个 样式 ， 那 么 在 使 用 了 SetLabel() 改 
变 文本 之 后 ， poU 件 不 将 自我 调整 尺寸 。 你 应 结合 使 用 一 个 居中 或 右 对 齐 的 


控件 来 保持 对 齐 


wx.StaticText 控件 覆盖 了 SetLabel() ， 以 便 根 据 新 的 文本 来 调整 自身 ， 除 
非 wx.ST. NO AUTORESIZE 样式 被 设置 了 。 


当 创 建 了 一 个 居中 或 右 对 齐 的 单行 静态 文本 时 ， 你 应 该 显 式 地 在 构造 器 中 设置 控件 
的 尺寸 。 指 定 尺 寸 以 防止 wxPython 自动 调整 该 控件 的 尺寸 。 wxPython 的 默认 

尺寸 是 刚好 包容 了 文本 的 矩形 尺寸 ， 因 此 对 齐 就 没有 什么 必要 。 要 在 程序 中 动态 地 
改变 窗口 部 件 中 的 文本 ， 而 不 改变 该 窗口 部 件 的 尺寸 ， 就 要 设 

i wx.ST NO AUTORESIZE 样式 。 这 样 就 防止 了 在 文本 被 重 置 后 ， 窗 口 部 件 自动 调 
整 尺寸 到 刚好 包容 了 文本 。 如 果 静 态 文 本 是 位 于 一 个 动态 的 布局 中 ， 那 么 改变 它 的 
尺寸 可 能 导致 屏幕 上 其 它 的 窗口 部 件 移 动 ， 这 就 对 用 户 产 生 了 干扰 。 


其 它 显 示 文 本 的 技术 


还 有 其 它 的 方法 来 显示 文本 。 其 中 之 一 就 

是 wx.lib.stattext.GenStaticText 类 ， 它 是 wx.StaticText 的 

^ Python 实现 。 它 比 标准 C++ 版 的 跨 平台 性 更 好 ， 并 且 它 接受 鼠标 事件 。 当 你 想 
子 类 化 或 创建 你 自己 的 静态 文本 控件 时 ， 它 是 更 可 取 的 。 


你 可 以 使 用 DrawText(text ,X, y) 和 DrawRotatedText(text , X, y, 

angle) 方法 直接 绘制 文本 到 你 的 设备 上 下 文 。 后 者 是 显示 有 一 定 角 度 的 文本 的 最 
容易 的 方法 ， 尽 管 GenStaticText 的 子 类 也 能 处 理 旋转 问题 。 设 备 上 下 文 在 第 6 
章 中 做 了 简短 的 说 明 ， 我 们 将 在 第 12 章 中 对 它 做 更 详细 的 说 明 。 


如 何 让 用 户 输 入 文本 ? 


超越 纯粹 显示 静态 文本 ， 我 们 将 开始 讨论 当 输 入 文本 时 的 用 户 交 互 。 wxPython 的 
文本 域 窗口 部 件 的 类 是 wx.TextCtrl ， 它 允许 单行 和 多 行文 本 输入 。 它 也 可 以 作 
为 密码 输入 控件 ， 掩 饰 所 按 下 的 按键 。 如 果 平 台 支 持 的 话 ， wx.TextCtrl 也 提供 
丰富 格式 文本 的 显示 ， 通 过 使 用 所 定义 和 显示 的 多 文本 样式 。 图 7.2 显 示 了 一 个 作为 
单行 控件 的 wx.TextCtrl 的 样板 。 其 中 的 密码 输入 框 对 密码 进行 了 掩饰 。 
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Figure 7.2 Examples of the 
single line text control, both plain 
and password 


接 下 来 ， 我 们 将 演示 如 何 创 建文 本 ， 然 后 讨论 文本 控件 的 样式 选项 。 
如 何 创建 文本 输入 控件 
例子 7.2 显 示 了 用 于 生成 图 7.2 的 代码 


例 7.2 wx.TextCtrl 的 单行 例子 


import wx 
class TextFrame(wx.Frame): 


def _ init (self): 
wx.Frame.__init__(self, None, -1, 'Text Entry Example', 
size-(300, 100)) 
panel - wx.Panel(self, -1) 
basicLabel - wx.StaticText(panel, -1, "Basic Control:") 
basicText = wx.TextCtrl(panel, -1, "I've entered some text!", 
size-(175, -1)) 
basicText.SetInsertionPoint(0) 


pwdLabel = wx.StaticText(panel, -1, "Password:") 
pwdText = wx.TextCtrl(panel, -1, "password", size=(175, -1), 
style-wx.TE PASSWORD) 
sizer = wx.FlexGridSizer(cols-2, hgap=6, vgap=6) 
sizer .AddMany([basicLabel, basicText, pwdLabel, pwdText] 


panel.SetSizer(sizer) 


if name == ' main ': 
app - wx.PySimpleApp() 
frame = TextFrame( ) 
frame.Show() 


app.MainLoop() 


wx.Textctrl 类 的 构造 函数 较 小 且 比 其 父 类 wx.Window 更 精细 ， 它 增加 了 两 个 
参数 : 


wx.TextCtrl(parent , id , value = , pos = wx.DefaultPosition , 
size = wx.DefaultSize , style -0, validator = wx.DefaultValidator 
name = wx.TextCtrlNameStr) 


参数 parent , id, pos, size, style ,和 name 4 wx.Window 构造 函数 
的 相同 。 value 是 显示 在 该 控件 中 的 初始 文本 。 


validator 参数 用 于 一 个 wx.Vvalidator ° validator 通常 用 于 过 虑 数据 以 确 
保 只 能 键入 要 接受 的 数据 。 将 在 第 9 章 对 validator 做 更 详细 的 讨论 。 


使 用 单行 文本 控件 样式 


这 里 ， 我 们 将 讨论 一 些 唯一 无 二 的 文本 控件 样式 。 表 7.3 说 明了 用 于 单行 文本 控件 
的 样式 标记 


表 7.3 单行 wx.Textctrl 的 样式 
WwX.TE CENTER : 控件 中 的 文本 居中 。 
wx.TE LEFT : 控件 中 的 文本 左 对 齐 。 默 认 行 为 。 


wx.TE NOHIDESEL : 文本 始终 高 亮 显示 ， 只 适用 于 windows ° 
wx.TE PASSWORD : 不 显示 所 键入 的 文本 ， 代 替 以 星 号 显示 。 


wx.TE_PROCESS ENTER : 如 果 使 用 了 这 个 样式 ， 那 么 当 用 户 在 控件 内 按 下 回 车 键 
时 ， 一 个 文本 输入 事件 被 触发 。 否 则 ， 按 键 事件 内 在 的 由 该 文本 控件 或 该 对 话 框 管 
38 o 


WwX.TE PROCESS TAB : 如 果 指 定 了 这 个 样式 ， 那 么 通常 的 字符 事件 在 Tab 键 按 
下 时 创建 (一般 意味 一 个 制 表 符 将 被 插入 文本 ) 。 否 则 ， tab 由 对 话 框 来 管理 ， 
通常 是 控件 间 的 切换 。 


WX.TE_READONLY :文本 控件 为 只 读 ， 用 户 不 能 修改 其 中 的 文本 。 
wx. TE RIGHT : 控件 中 的 文本 右 对 齐 。 


像 其 它 样 式 标 记 一 样 ， 它 们 可 以 使 用 | 符号 来 组 合 使 用 ， 尽 管 其 中 的 三 个 对 齐 标记 是 
相互 排斥 的 。 


对 于 添加 文本 和 移动 插入 点 ， 该 文本 控件 自动 管理 用 户 的 按键 和 鼠标 事件 。 对 于 该 
文本 控件 可 用 的 命令 控制 组 合 说 明 如 下 : 


e ctrl-x: S4) ctrl -c :复制 ctrl -v :粘贴 ctrl -z :撤消 


不 输入 的 情况 下 如 何 改 变 文本 ? 
除了 根据 用 户 的 输入 改变 显示 的 文本 外 ， wx.Textctrl 提供 了 在 程序 中 改变 显示 


的 文本 的 一 些 方法 。 你 可 以 完全 改变 文本 或 仅 移动 插入 点 到 文本 中 不 同 的 位 置 。 表 
7.4 列 出 了 wx.TextCtrl 的 文本 处 理 方法 。 


表 7.4 
AppendText(text) : 在 尾部 添加 文本 。 
Clear() : 重 置 控件 中 的 文本 为 ”。 并 且 生 成 一 个 文本 更 新 事件 。 


EmulateKeyPress(event) :产生 一 个 按键 事件 ， 插 入 与 事件 相关 联 的 控制 符 ， 
就 如 同 实际 的 按键 发 生 了 。 


GetInsertionPoint() SetInsertionPoint(pos) 
SetInsertionPointEnd() :得 到 或 设置 插入 点 的 位 置 ， 位 置 是 整 型 的 索引 值 。 
控件 的 开始 位 置 是 0 。 


GetRange(from , to) : 返回 控件 中 位 置 索引 范围 内 的 字符 串 。 


GetSelection()  GetStringSelection()  SetSelection(from , 
to) : GetSelection() 以 元 组 的 形式 返回 当前 所 选择 的 文本 的 起 始 位 置 的 索引 


fa (开始 ， 结束) © GetstringSelection() 得 到 所 选择 的 字符 
串 。 Setselection(from , to) 设置 选择 的 文本 。 


GetValue()  SetValue(value) : SetValue() 改变 控件 中 的 全 部 文 
本 。 GetValue() 返回 控件 中 所 有 的 字符 串 。 


Remove(from , to) : 删除 指定 范围 的 文本 。 


Replace(from , to , value) : 用 给 定 的 值 蔡 换 掉 指定 范围 内 的 文本 。 这 可 以 
改变 文本 的 长 度 。 
WriteText(text) : 类 似 于 AppendText() ， 只 是 写 入 的 文本 被 放置 在 当前 的 
插入 点 。 
当 你 的 控件 是 只 读 的 或 如 果 你 根据 事件 而 非 用 户 键盘 输入 来 改变 控件 中 的 文本 是 ， 
这 些 方 法 是 十 分 有 用 的 。 


如 何 创 建 一 个 多 行 或 样式 文本 控件 ? 


你 可 以 使 用 wx.TE MULTILINE 样式 标记 创建 一 个 多 行文 本 控件 。 如 果 本 地 窗口 控 
件 支 持 样式 ， 那 么 你 可 以 改变 被 控件 管理 的 文本 的 字体 和 颜色 样式 ， 这 有 时 被 称 为 
丰富 格式 文本 。 对 于 另外 的 一 些 平台 ， 设 置 样式 的 调用 被 忽视 掉 了 。 图 7.3 显 示 了 多 
行文 本 控件 的 一 个 例子 。 
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Figure 7.3 Examples of multi- 
line text controls, both with and 
without rich text 


例 7.3 包 含 了 用 于 创建 图 7.3 的 代码 。 通 常 ， 创 建 一 个 多 行文 本 控件 是 通过 设 
置 wx.TE MULTILINE 样式 标记 来 处 理 的 。 较 后 的 部 分 ， 我 们 将 讨论 使 用 丰富 文本 


样式 。 
例 7.3 创建 一 个 多 行文 本 控件 

















import wx 
class TextFrame(wx.Frame): 


def __init_ (self): 
wx.Frame.__init__(self, None, -1, 'Text Entry Example', 
size-(300, 250)) 
panel - wx.Panel(self, -1) 
multiLabel - wx.StaticText(panel, -1, "Multi-line") 
multiText = wx.TextCtrl(panel, -1, 
"Here is a looooooooooooooong line of text set in 
the control.\n\n" 
"See that it wrapped, and that this line is after 
a blank", 
size=(200, 100), style-wx.TE MULTILINE) # 创 建 一 个 文 
本 控件 
multiText.SetInsertionPoint(0) # 设 置 插入 点 


richLabel = wx.StaticText(panel, -1, "Rich Text") 
richText = wx.TextCtrl(panel, -1, 
"If supported by the native control, this is rev 
ersed, and this is a different font.", 
size-(200, 100), style-wx.TE MULTILINE|wx.TE RIC 
H2) # 创 建 丰富 文本 控件 
richText.SetInsertionPoint (0) 
richText.SetStyle(44, 52, wx.TextAttr("white", "black")) 
# 设 置 文本 样式 
points = richText.GetFont().GetPointSize() 
f = wx.Font(points + 3, wx.ROMAN, wx.ITALIC, wx.BOLD, Tr 
ue) # 创 建 一 个 字体 
richText.SetStyle(68, 82, wx.TextAttr("blue", wx.NullCol 
our, f)) # 用 新 字体 设置 样式 
sizer = wx.FlexGridSizer(cols=2, hgap=6, vgap=6) 
sizer .AddMany([multiLabel, multiText, richLabel, richTex 
t]) 


panel.SetSizer(sizer) 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = TextFrame( ) 
frame.Show() 
app.MainLoop() 


使 用 多 行 或 丰富 文本 样式 


除了 wx.TE MULTILINE ， 还 有 另外 的 样式 标记 ， 它 们 只 在 一 个 多 行 或 丰 宣 
件 的 上 下 文中 有 意义 。 表 7.5 列 出 了 这 些 窗口 样式 。 


表 7.5 


Eo) 
n" 
> 
ux 


wX.HSCROLL : 如 果 文 本 控件 是 多 行 的 ， 并 且 如 果 该 样式 被 声明 了 ， 那 么 长 的 行 
将 不 会 自动 换行 ， 并 显示 水 平 滚 动 条 。 该 选项 在 GTK + 中 被 忽略 。 


wX.TE AUTO URL : 如 果 丰 富 文本 选项 被 设置 并 且 平 台 支 持 的 话 ， 那 么 当 用 户 的 
和 鼠标 位 于 文本 中 的 一 个 URL 上 或 在 该 URL 上 敲 击 时 ， 这 个 样式 将 导致 一 个 事件 被 
生成 。 


wx.TE_DONTWRAP : wx.HSCROLL 的 别名 。 


wx.TE LINEWRAP : 对 于 太 长 的 行 ， 以 字符 为 界 换 行 。 某 些 操作 系统 可 能 会 忽略 
该 样式 。 


wx.TE MULTILINE : 文本 控 4 多 行 。 


件 将 显示 
wx.TE RICH :用 于 windows 下 ， 丰 富 文本 控件 用 作 基 本 的 窗口 部 件 。 这 允许 样 
式 文本 的 使 用 。 


wx.TE RICH2 : 用 于 windows 下 ， 把 最 新 版 本 的 丰富 文本 控件 用 作 基 本 的 窗口 
部 件 。 


wx.TE WORDWRAP : 对 于 太 长 的 行 ， 以 单词 为 界 换行 。 许 多 操作 系统 会 忽略 该 样 
式 。 


记 住 ， 上 面 这 些 样式 可 以 组 合 使 用 ， 所 以 上 面 例子 中 的 多 行 丰富 文本 控件 使 
用 wx.TE MULTILINE | wx.TE_RICH2 来 声明 。 


用 在 wx.TextCtrl 窗口 部 件 中 的 文本 样式 是 类 wx.TextAttr 893 
f|» wx.TextAttr 实例 的 属性 有 文本 颜色 、 背 景色 、 和 字体 ， 它 们 都 能 够 在 构造 
BaP RAGE > to A HR : 


wx.TextAttr(colText , colBack = wx.NullColor , font = wx.NullFont) 


ce pde wxPython 对 象 ， 它 们 可 以 使 用 颜色 名 或 颜色 的 RGB 值 ( 红 , 绿 
蓝 ) 来 指定 。 wx.NullColor 指明 使 用 控件 目前 的 背景 色 。 font 是 一 

个 wx.Font 对 象 ， 我 们 将 在 下 一 小 节 讨 论 。 wx.NullFont 对 象 指 明 使 用 当前 默 

认 字 体 。 


类 wx.TextAttr 有 相关 属性 的 get () 方 法 : GetBackgroundColour() , 
GetFont() ,和 GetTextColour() ， 也 有 返回 布 尔 值 的 验证 存在 性 的 方 

法 : HasBackgroundColour() , HasFont() ,和 HasTextColour() 。 如 果 属 
性 包含 一 个 默认 值 ， 则 Has () 方 法 返回 False 。 如 果 所 有 这 三 个 属性 都 包含 默认 
值 ， 则 IsDefault() 方法 返回 true 。 这 个 类 没有 set *() 方 法 ， 

为 wx.TextAttr 的 实例 是 不 可 变 的 。 要 改变 文本 的 样式 ， 你 必须 创建 一 个 实例 。 


使 用 文本 样式 ， 要 调用 SetDefaultStyle(style) 或 SetStyle(start , 

end , style) 。 第 一 个 方法 设置 为 控件 当前 的 样式 。 任 何 插入 到 该 控件 中 的 文 
本 ， 不 管 是 键入 的 ， 或 使 用 了 AppendText() 或 WriteText() 方法 的 ， 都 以 该 
样式 显示 。 如 果 样 式 的 某 个 属性 是 默认 的 ， 那 么 该 样式 的 当前 值 被 保留 。 但 是 

果 样 式 的 所 有 属性 都 是 默认 的 ， 那 么 恢复 默认 样 


A ° SetStyle() 4 SetDefaultstyle(style) 类 似 ， 只 是 立即 对 位 于 start 
和 end 位 置 之 间 的 文本 起 作用 。 样 式 参数 中 的 默认 属性 通过 检查 该 控件 的 当前 默 
认 样 式 来 解决 。 例 7.3 使 用 下 面 一 行 代码 来 反 转 文本 中 几 个 字符 的 颜色 : 


richText.SetStyle(44 , 52, wx.TextAttr( " white "," black ")) 
背景 色 变 为 了 黑色 ， 相 应 的 字符 变 为 了 白色 。 
表 7.6 列 出 了 wx.Textctrl 的 方法 ， 它 们 在 处 理 多 行 控件 和 丰富 文本 中 是 有 用 的 。 
表 7.6 

GetDefaultStyle() SetDefaultStyle(style) : 上 面 已 作 了 说 明 。 
GetLineLength(lineNo) :返回 给 定 行 的 长 度 的 整数 值 。 
GetLineText(lineNo) : 返回 给 定 行 的 文本 。 

GetNumberOfLines() :返回 控件 中 的 行 的 数量 。 对 于 单行 ， 返 回 1。 
IsMultiLine() IsSingleLine() :布尔 类 型 的 方法 ， 确 定 控 件 的 状态 。 


PositionToXY(pos) : 指定 文本 内 的 一 个 整数 值 位 置 ， 返 回 以 元 组 ( 列 ， 行 ) 形 式 
的 索引 位 置 。 列 和 行 的 索引 值 均 以 0 作为 开始 。 


SetStyle(start , end , style) : 立即 改变 指定 范围 内 文本 的 样式 。 
ShowPosition(pos) : 引起 一 个 多 行 控件 的 滚动 ， 以 便 观 察 到 指定 位 置 的 内 容 。 


指定 行 和 列 ， 返 回 整 





XYToPosition(x ，y) : 5 PositionToXY(pos) 相反 
数值 位 置 。 


如 果 你 能 在 系统 中 使 用 任意 字体 的 话 ， 那 么 就 可 以 更 加 灵活 的 创建 样式 。 接 下 来 ， 
我 们 将 给 你 展示 如 何 创建 和 使 用 字体 实例 。 
如 何 创建 一 个 字体 ? 


字体 是 类 wx.Font 的 实例 。 你 所 访问 的 任何 字体 ， 它 已 经 被 安装 并 对 于 基本 的 系 
统 是 可 访问 的 。 创 建 一 个 字体 实例 ， 要 使 用 如 下 的 构造 函数 : 


wx.Font(pointSize , family , style , weight , underline = False , 
faceName ="", encoding = wx.FONTENCODING DEFAULT) 


pointSize 是 字体 的 以 磅 为 单位 的 整数 尺寸 。 family 用 于 快速 指定 一 个 字体 而 
无 需 知 道 该 字体 的 实际 的 名 字 。 字 体 的 准确 选择 依赖 于 系统 和 具体 可 用 的 字体 。 可 
用 的 字体 类 别 的 示例 显示 在 表 7.7 中 。 你 所 得 到 的 精确 的 字体 将 依赖 于 你 的 系统 。 


表 7.7 
wX.DECORATIVE : 一 个 正式 的 ， 老 的 英文 样式 字体 。 


wx.DEFAULT : 系统 默认 字体 。 


wx.MODERN : 一 个 单间 隔 (固定 字符 间距 ) 字体 。 

wx.ROMAN : serif 字体 ， 通 常 类 似 于 Times New Roman ° 
WX.SCRIPT :手写 体 或 草 写 体 

wx.SWISS : sans - serif 字体 ， 通 常 类 似 于 Helvetica X Arial ° 


style 参数 指明 字体 的 是 否 倾斜 ， 它 的 值 有 : wx.NORMAL , wx.SLANT ,和 
wx.ITALIC 。 同 样 ， weight 参数 指明 字体 的 醒目 程度 ， 可 选 值 

Æ : wx.NORMAL , wx.LIGHT ,或 wx.BOLD 。 这 些 常量 值 的 行为 根据 它 的 名 字 就 
可 以 知道 了 。 underline 参数 仅 工作 在 windows 系统 下 ， 如 果 取 值 为 True * 
则 加 下 划 线 ， False 为 无 下 划 线 。 faceName 参数 指定 字体 名 。 


encoding 参数 允许 你 在 几 个 编码 中 选择 一 个 ， 它 映射 内 部 的 字符 和 字 本 显示 字 
符 。 编 码 不 是 Unicode 编码 ， 只 是 用 于 wxPython 的 不 同 的 8 位 编码 。 大 多 数 情 
况 你 可 以 使 用 默认 编码 。 


为 了 获取 系统 的 有 效 字体 的 一 个 列表 ， 并 使 用 户 可 用 它们 ， 要 使 用 专门 的 
类 wx.FontEnumerator ， 如 下 所 示 : 


e= wx.FontEnumerator()  e.EnumerateFacenames()  fontList = 
e.GetFacenames() 


要 限制 该 列表 为 固定 宽度 ， 就 要 将 上 面 的 第 一 行 改 为 6 = 
wx.FontEnumerator(fixedwidth = True) ° 


Ae ZR RM KAA LAFF GLA > BA RRA A AACA ? 


可 以 。 在 wxPython 中 有 一 个 跨 平 台 的 样式 文本 窗口 部 件 ， 名 

A wx.stc.StyledTextCtrl ， 它 是 Python 对 Scintilla 丰富 文本 组 件 的 封 
装 。 因 为 Scintilla 不 是 wxWidgets 的 一 部 分 ， 而 是 作为 一 个 独立 的 第 三 方 组 
被 合并 到 了 wxPython 中 ， 所 以 它 不 与 我 们 已 经 讨论 过 的 类 共享 相同 

的 API ° wx.stc.StyledCtrl 的 完整 说 明 超过 了 我 们 要 讲 的 范围 ， 但 是 你 可 以 
在 http: // wiki.wxpython.org / index.cgi / wxStyledTextCtrl 找到 相关 
的 文档 。 


如 果 我 的 文本 控件 不 匹配 我 的 字符 串 该 怎么 办 ? 


当 使 用 多 行 wx.Textctrl 的 时 候 ， 要 知道 的 一 点 是 ， 该 文本 控件 是 以 何 种 方式 存 
储 字符 串 的 。 在 内 部 ， 存 储 在 该 wx.TextCtrl 中 的 多 行 字 符 是 以 \n 作 为 行 的 分 隔 
符 的 。 这 与 基本 的 操作 系统 无 关 ， 即 使 某 些 系统 使 用 了 不 同 的 字符 组 合作 为 一 行 的 
分 隔 符 。 当 你 使 用 Getvalue() 来 获取 该 字符 串 时 ， 原 来 的 行 分 隔 符 被 还 原 ， 

此 你 不 必 考 虑 手工 转换 。 这 个 的 好 处 就 是 控件 中 的 文本 不 依赖 于 任何 特定 的 操作 系 
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缺点 是 ， 文 本 控件 中 的 行 的 长 度 和 行 的 索引 与 它们 在 文本 控件 外 的 可 能 是 不 同 的。 
例如 ， 如 果 你 在 一 个 Windows 系统 上 上， 系统 所 用 的 行 分 隔 符 是 \\n， 通 
过 GetValue() 所 得 知 的 字符 串 的 长 度 将 比 通过 GetLastPosition() 所 得 知 的 


字符 串 的 结尾 长 。 通 过 在 例 7.3 中 增加 下 面 两 行 : 


print getValue ", len(multiText.GetValue()) print " lastPos ", 
multiText.GetLastPosition() 


我 们 在 Unix 系统 上 所 得 的 结果 应 该 是 : 
getValue 119 lastPos 119 

我 们 在 Windows 系统 上 所 得 的 结果 应 该 是 : 
getValue 121 lastPos 119 


这 意味 你 不 应 该 使 用 多 行文 本 控件 的 位 置 索引 来 取得 原 字 符 串 ， 位 置 索引 应 该 用 
Ve wx.TextCtrl 的 另外 方法 的 参数 。 对 于 该 控件 中 的 文本 的 子囊 ， 应 该 使 

用 GetRange() 或 GetselectedText() 。 也 不 要 反 向 索引 ; 不 要 使 用 原 字 符 串 
的 索引 来 取得 并 放 入 文本 控件 中 。 下 面 是 一 个 例子 ， 它 使 用 了 不 正确 的 方法 在 插入 
点 之 后 直接 得 到 10 个 字符 : 


aLongString = """Any old 

multi line string 

will do here. 

Just as long as 

it is multiline""" 

text - wx.TextCtrl(panel, -1, aLongString, style-wx.TE MULTILINE 
) 


x = text.GetInsertionPoint() 
selection = aLongString[x : x + 10] ### 这 将 是 不 正确 的 
在 Windows 或 Mac 系统 中 要 得 到 正确 的 结果 ， 最 后 一 行 应 换 为 : 


selection = text.GetRange(x ,x + 10) 


如 何 响应 文本 事件 ? 


有 一 个 由 wx.Textctrl 窗口 部 件 产生 的 便利 的 命令 事件 ， 你 可 能 想 用 它 。 你 需要 
把 相关 事件 传递 给 Bind 方法 以 捕获 该 事件 ， 如 下 所 示 : 


frame.Bind(wx.EVT_TEXT , frame.OnText , text) 
表 7.8 说 明了 这 些 命令 事件 。 
表 7.8 wx.TextCtrl 的 事件 


EVT TEXT : 当 控 件 中 的 文本 改变 时 产生 该 事件 。 文 本 因 用 户 的 输入 或 在 程序 中 使 
用 setvalue() 而 被 改变 ， 都 要 产生 该 事件 。 


EVT TEXT ENTER : 2 FP #—~* wx.TE PROCESS ENTER 样式 的 文本 控件 中 按 
下 了 回 车 键 时 ， 产 生 该 事件 。 


EVT TEXT URL : 如 果 在 Windows 系统 上 ， wx.TE_RICH 或 wx.TE RICH2 样 
式 被 设置 了 ， 并 且 wx.TE AUTO URL 样式 也 被 设置 了 ， 那 么 当 在 文本 控件 内 

的 URL 上 发 生 了 一 个 鼠标 事件 时 ， 该 事件 被 触发 。 

EVT TEXT MAXLEN : 如 果 使 用 setMaxLength() 指定 了 该 控件 的 最 大 长 度 ， 那 
和 勾当 用 户 试图 输入 更 长 的 字符 串 时 ， 该 事件 被 触发 。 你 可 能 会 用 这 个 ， 例 如 ， 这 时 
给 用 户 显示 一 个 警告 消息 。 


接 下 来 ， 让 我 们 来 讨论 被 主要 设计 来 得 到 鼠标 输入 的 控件 。 其 中 最 简单 的 就 是 按 
$J o 


使 用 按钮 工作 

在 wxPython 中 有 很 多 不 同类 型 的 按钮 。 这 一 节 ， 我 们 将 讨论 文本 按钮 、 位 图 按 
钮 、 开 关 按 钮 ( toggle buttons ) 和 通用 ( generic ) 按钮 。 

如 何 生成 一 个 按钮 ? 


在 第 一 部 分 ( part 1) 中 ， 我 们 已 经 说 明了 几 个 按钮 的 例子 ， 所 以 这 里 我 们 只 简 
短 的 涉及 它 的 一 些 基本 的 东西 。 图 7.4 显 示 了 一 个 简单 的 按钮 。 


图 7.4 
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Figure 7.4 Asimple button 
使 用 按钮 是 非常 简单 的 。 例 7.4 显 示 了 该 简单 按钮 的 代码 。 
例 7.4 创建 并 显示 一 个 简单 的 按钮 


import wx 


class ButtonFrame(wx.Frame): 
def _init_ (self): 
wx.Frame.__init__(self, None, -1, 'Button Example', 
size-(300, 100)) 
panel - wx.Panel(self, -1) 
self.button = wx.Button(panel, -1, "Hello", pos=(50, 20) 


) 
self.Bind(wx.EVT BUTTON, self.OnClick, self.button) 
self.button.SetDefault() 
def OnClick(self, event): 
self.button.SetLabel("Clicked") 
if _name__ == ' main ': 


app - wx.PySimpleApp() 
frame = ButtonFrame() 
frame.Show() 
app.MainLoop() 


wx.Button 的 构造 函数 类 似 于 我 们 已 经 看 到 过 的 ， 如 下 所 示 : 


wx.Button(parent , id, label , pos , size = wxDefaultSize 
style =0, validator , name =" button ") 


参数 label 是 显示 在 按钮 上 的 文本 。 它 可 以 在 程序 运行 期 间 使 用 setLabel() 来 
改变 ， 并 且 使 用 GetLabel() 来 获取 。 另 外 两 个 有 用 的 方法 

是 GetDefaultSize() 和 SetDefault() 。 GetDefaultSize() 返回 系统 默认 

按钮 的 尺寸 (对 于 框架 间 的 一 致 性 是 有 用 的 ) ; SetDefault() 设置 按钮 为 对 话 

框 或 框架 的 默认 按钮 。 默 认 按 钮 的 绘制 不 同 于 其 它 按钮 ， 它 在 对 话 框 获得 焦点 时 ， 
通常 按 下 回 车 键 被 激活 。 


wx.Button 类 有 一 个 跨 平 台 的 样式 标记 : wx.BU EXACTFIT 。 如 果 定 义 了 这 个 标 
记 ， 那 么 按钮 就 不 把 系统 默认 的 尺寸 作为 最 小 的 尺寸 ， 而 是 把 能 够 恰好 击 充 标签 的 
尺寸 作为 最 小 尺寸 。 如 果 本 地 窗口 部 件 支持 的 话 ， 你 可 以 使 用 标记 wx.BU LEFT , 

wx.BU_RIGHT , wx.BU TOP ,和 wx.BU BOTTOM 来 改变 按钮 中 标签 的 对 齐 方 
式 。 每 个 标记 对 齐 标签 到 边 ， 该 边 你 根据 标记 的 名 字 可 以 知道 。 正 如 我 们 在 第 一 部 
分 中 所 讨论 过 的 ， wx.Button 在 被 斋 击 时 触发 一 个 命令 事件 ， 事 件 类 型 
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x EVT BUTTON ° 


如 何 生成 一 个 位 图 按钮 ? 


有 了 时候， 你 可 能 想 在 你 的 按钮 上 显示 一 个 图 片 ， 而 非 一 个 文本 标签 ， 如 图 7.5 所 示 。 
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Figure 7.5 A demonstration of 
a basic bitmap button. The left 
button is drawn with a 3D effect. 


在 wxPython 中 ， 使 用 类 wx.BitmapButton 来 创建 一 个 位 图 按钮 。 处 理 一 
个 wx.BitmapButton 的 代码 是 与 通用 按钮 的 代码 非常 类 似 的 ， 例 7.5 显 示 了 产生 
7.5 的 代码 。 


例 7.5 创建 一 个 位 图 按钮 


import wx 


class BitmapButtonFrame(wx.Frame): 
def — init (self): 
wx.Frame. init (self, None, -1, 'Bitmap Button Example', 
size=(200, 150)) 

panel = wx.Panel(self, -1) 

bmp = wx.Image("bitmap.bmp", wx.BITMAP TYPE BMP).Convert 
ToBitmap() 

self.button - wx.BitmapButton(panel, -1, bmp, pos-(10, 2 
9)) 

self.Bind(wx.EVT BUTTON, self.OnClick, self.button) 

self.button.SetDefault() 
self.button2 - wx.BitmapButton(panel, -1, bmp, pos-(100, 20), 

style-0) 
self.Bind(wx.EVT BUTTON, self.OnClick, self.button2) 


def OnClick(self, event): 
self.Destroy() 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = BitmapButtonFrame( ) 
frame.Show( ) 
app .MainLoop( ) 


与 普通 按钮 的 主要 的 区 别 是 你 需要 提供 一 个 位 图 ， 而 非 一 个 标签 。 否 则 ， 构 造 器 和 
大 部 分 代码 是 与 文本 按钮 的 例子 相同 的 。 位 图 按钮 在 被 敲 击 时 同样 产 
生 EVT_BUTTON 事件 。 


关于 位 图 按钮 有 几 个 有 趣 的 特性 。 首 先 ， 一 个 样式 标记 wx.BU_AUTODRAW ， 它 是 
默认 的 。 如 果 该 标记 是 打开 的 ， 那 么 位 图 将 带 有 一 个 3D 的 边框 ， 这 使 它 看 起 来 像 一 
个 文本 按钮 (图 7.5 中 的 左 按 钮 ) ， 并 且 按 钮 比 原 位 图 大 几 个 像素 。 如 果 该 标记 是 关 
闭 的 ， 则 位 图 被 简单 地 绘制 为 按钮 而 没有 边框 。 通 过 设置 style =0 使 图 7.5 中 右边 
的 按钮 关闭 默认 设置 ， 它 没有 了 3D 的 效果 。 


an 


n ， 给 wxPython 传递 单个 位 图 作为 主 显 示 的 位 图 ， 在 当 按 钮 被 按 下 或 获 
时 焦点 或 无 效 时 ， wxPython 自动 创建 一 个 标准 的 派生 自主 显示 的 位 图 的 位 图 作为 

LHe chee Lee 如 果 自 动 创 建 的 位 图 不 是 你 想 要 的 ， 你 可 以 使 用 下 面 的 

方法 : SetBitmapDisabled() , SetBitmapFocus() , SetBitmapLabel() , 

fe SetBitmap - Selected() 显 式 地 告诉 wxPython 你 要 使 用 哪个 位 图 。 这 些 方 

法 都 要 求 一 个 wx.Bitmap 对 象 作为 参数 ， 并 且 它 们 都 有 相应 的 get *() 方 法 。 


你 不 能 通过 使 用 标准 的 wxWidgets C++ 库 来 合并 一 个 位 图 和 文本 。 你 可 以 创建 一 
个 包含 文本 的 位 图 。 然 而 ， 正 如 我 们 将 在 通用 按钮 问题 讨论 中 所 看 到 
的 ， wxPython 有 额外 的 方法 来 实现 这 一 合并 行为 。 


=== 如 何 创建 开关 按钮 ( toggle button ) ?=== 


你 可 以 使 用 wx.ToggleButton 创建 一 个 开关 按钮 ( toggle button ) 。 开 关 
按钮 ( toggle button ) 看 起 来 十 分 像 文本 按钮 ， 但 它 的 行为 更 像 复 选 框 ， 它 
的 选择 或 非 选择 状态 是 可 视 化 的 。 换 和 名 话说 ， P ea ( toggle 
button ) 时 ， 它 将 一 直 保 持 被 按 下 的 状态 直到 你 再 次 斋 击 它 


在 wx.ToggleButton 与 父 类 wx.Button 之 间 只 有 两 个 区 别 : 


1、 当 被 敲 击 时 ， wx.ToggleButton 发 送 一 个 EVT TOGGLEBUTTON 事件 。 
2^ wx.ToggleButton 有 GetValue() 和 SetValue() 方法 ， 它 们 处 理 按钮 的 
二 进 制 状态 。 


开关 按钮 ( toggle button ) 是 有 用 的 ， 它 相对 于 复 选 框 是 另 一 好 的 选择 ， 特 
别 是 在 工具 栏 中 。 记 住 ， 你 不 能 使 用 wxWidgets 提供 的 对 象 来 将 开关 按钮 

( toggle button ) 与 位 图 按钮 合并 ， 但 是 wxPython 有 一 个 通用 按钮 类 ， 它 
提供 了 这 种 行为 ， 我 们 将 在 下 一 节 对 其 作 讨论 。 


什么 是 通用 按钮 ， 我 为 什么 要 使 用 它 


通用 按钮 是 一 个 完全 用 Python 重新 实现 的 一 个 按钮 窗口 部 件 ， 回 避 了 本 地 系统 
口 部 件 的 用 法 。 它 的 父 类 是 wx.lib.buttons.  GenButton 。 通 用 按钮 有 通 用 位 
图 和 切换 按钮 。 


这 儿 有 几 个 使 用 通用 按钮 的 原因 : 

、 通 用 按钮 比 本 地 按钮 具有 更 好 的 跨 平台 的 外 观 。 另 一 方面 ， 通 用 按钮 可 能 在 具 
体 的 系统 上 看 起 来 与 本 地 按钮 有 些微 的 不 同 。 
2、 使 用 通用 按钮 ， 你 对 它 的 外 观 有 更 多 的 控制 权 ， 并 且 能 改变 属性 ， 如 3D 斜 面 的 
宽度 和 颜色 ， 而 这 对 于 本 地 控件 可 能 是 不 允许 的 。 


3、 通 用 按钮 类 允许 特性 的 合并 ， 而 wxWidget 按钮 不 行 。 比 
如 GenBitmapTextButton 允许 文本 标签 和 位 图 的 组 
合 ， GenBitmapToggleButton 实现 一 个 位 图 切换 按钮 。 


4、 如 果 你 正在 创 ， 使 用 通用 按钮 是 较 容易 的 。 由 于 其 代码 和 参数 是 


用 Python 写 的 ， 所 以 当 创建 一 个 新 的 子 类 的 时 候 ， 对 于 检查 和 徐 盖 ， 它 们 的 可 用 
性 更 好 。 


图 7.6 显 示 了 实际 的 通用 按钮 和 常规 按钮 的 对 照 。 
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例 7.6 显 示 了 产生 图 7.6 的 代码 。 第 二 个 导入 语句 : import wx.lib.buttons 
as buttons ， 是 必须 的 ， 它 使 得 通用 按钮 类 可 用 。 


例 7.6 创建 和 使 用 wxPython 的 通用 按钮 


import wx 
import wx.lib.buttons as buttons 


class GenericButtonFrame(wx.Frame): 
def — init (self): 
wx.Frame. init (self, None, -1, 'Generic Button Example', 


Size-(500, 350)) 
panel - wx.Panel(self, -1) 


sizer = wx.FlexGridSizer(i1, 3, 20, 20) 

b = wx.Button(panel, -1, "A wx.Button") 

b.SetDefault() 

sizer.Add(b) 

b - wx.Button(panel, -1, "non-default wx.Button") 
sizer.Add(b) 

sizer.Add((10,10)) 

b = buttons.GenButton(panel, -1, 'Genric Button' )# 基 本 的 
sizer.Add(b) 


b = buttons.GenButton(panel, -1, 'disabled Generic'J)4 Xx 


的 通用 按钮 


的 按钮 


e)) 


b.Enable(False) 
sizer.Add(b) 


b = buttons.GenButton(panel, -1, 'bigger')# X 3 A fef Ë 
b.SetFont(wx.Font(20, wx.SWISS, wx.NORMAL, wx.BOLD, Fals 


b.SetBezelwidth(5) 


b.SetBackgroundColour ("Navy") 

b.SetForegroundColour ("white") 

b.SetToolTipString("This is a BIG button...") 
sizer .Add(b) 


bmp = wx.Image("bitmap.bmp", wx.BITMAP_TYPE_BMP).Convert 
ToBitmap( ) 

b = buttons.GenBitmapButton(panel, -1 二，bmp )# 通 用 位 图 按钮 

sizer .Add(b) 


b = buttons.GenBitmapToggleButton(panel, -1, bmp) #24 M tz 
图 开关 按钮 
sizer .Add(b) 


b = buttons.GenBitmapTextButton(panel, -1, bmp, "Bitmapp 
ed Text", 
SIize=(175，75) )# 位 图 文本 按钮 
b.SetUseFocusIndicator (False) 
sizer .Add(b) 


b = buttons.GenToggleButton(panel, -1, "Toggle Button")# 
通用 开关 按钮 
sizer .Add(b) 


panel.SetSizer(sizer) 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = GenericButtonFrame() 
frame.Show() 

app.MainLoop() 


在 例 7.6 中 ， 通 用 按钮 的 用 法 非常 类 似 于 常规 按钮 。 通 用 按钮 产生 与 常规 按钮 同样 
的 EVT_BUTTON 和 EVT_TOGGLEBUTTON 事件 。 通 用 按钮 引入 

了 GetBevelwidth() 和 SetBevelwidth() 方法 来 改变 3D 和 斜面 效果 。 它 们 用 在 
了 图 7.6 中 大 按钮 上 。 


通用 位 图 按钮 类 GenBitmapButton 工作 的 像 标准 的 wxPython 版 本 。 在 构造 器 
中 。 GenBitmapTextButton 要 求 先 要 一 个 位 图 ， 然 后 是 文本 。 通 用 

类 GenToggleButton , GenBitmapToggleButton ,和 
GenBitmapTextToggleButton 与 非 开 关 版 的 一 样 ， 并 且 对 于 处 理 按钮 的 开关 状 
态 响应 于 GetToggle() 和 SetToggle() ° 


在 下 一 节 ， 我 们 将 讨论 关于 使 你 的 用 户 能 够 输入 或 观看 一 个 数字 值 的 方案 。 


输入 并 显示 数字 


有 时 你 想 要 显示 图 形 化 的 数字 信息 ， 或 你 想 让 用 户 不 必 使 用 键盘 来 输入 一 个 数字 
量 。 在 这 一 节 ， 我 们 将 浏览 wxPython 中 用 于 数字 输入 和 显示 的 工具 : 滑 块 
( slider ) 、 微 调控 制 框 和 显示 量度 的 标尺 。 


如 何 生成 一 个 滑 块 ? 

滑 块 是 一 个 窗口 部 件 ， 它 允许 用 户 通过 在 该 控件 的 尺度 finde DR esate nes 
值 。 在 wxPython 中 ， 该 控件 类 是 wx.Slider ， 它 包括 了 滑 块 的 当前 值 的 只 读 文 
本 的 显示 。 图 7.7 显 示 了 水 平和 重 直 滑 块 的 例子 。 

图 7.7 
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Figure 7.7 Avertical wx. Slider 
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滑 块 的 基本 使 用 是 十 分 简单 的 ， 但 是 你 可 以 增加 许多 事件 。 
如 何 使 用 滑 块 

例 7.7 是 产生 图 7.7 的 例子 。 

例 7.7 水 平和 重 直 滑 块 的 显示 代码 


import wx 


class SliderFrame(wx.Frame): 
def — init (self): 
wx.Frame. (init (self, None, -1, 'Slider Example', 
size-(300, 350)) 
panel - wx.Panel(self, -1) 
self.count = 0 
slider = wx.Slider(panel, 100, 25, 1, 100, pos=(10, 10), 
size=(250, -1), 
style=wx.SL_HORIZONTAL | wx.SL_AUTOTICKS | wx.SL 
LABELS ) 
slider.SetTickFreq(5, 1) 
slider - wx.Slider(panel, 100, 25, 1, 100, pos-(125, 70) 


size=(-1, 250), 
style-wx.SL VERTICAL | wx.SL AUTOTICKS | wx.SL L 
ABELS ) 
slider.SetTickFreq(20, 1) 


if | name == ' main ': 
app - wx.PySimpleApp() 
frame = SliderFrame() 
frame.Show() 

app.MainLoop() 


通常 ， 当 你 使 用 wx.Slider 类 时 ， 所 有 你 所 需要 的 就 是 一 个 构造 函数 ， 它 与 别 的 
调用 不 同 ， 如 下 所 示 : 


wx.Slider(parent , id , value , minValue , maxValue 
pos = wxDefaultPosition , size = wx.DefaultSize 
style = wx.SL HORIZONTAL , validator = wx.DefaultValidator 


name -" slider ") 


value 是 滑 块 的 初始 值 ， 而 minvalue 和 maxValue 是 两 端的 值 。 
使 用 滑 块 样式 工作 

滑 块 的 样式 管理 滑 块 的 位 置 和 方向 ， 如 下 表 7.9 所 示 。 

表 7.9 wx.Slider 的 样式 


Wx.SL_AUTOTICKS : 如 果 设 置 这 个 样式 ， 则 滑 块 将 显示 刻度 。 刻 度 间 的 间隔 通 
过 SetTickFreq 方法 来 控制 。 


wX.SL HORIZONTAL : 水 平滑 块 。 这 是 默认 值 。 


wX.SL LABELS : 如 果 设 置 这 个 样式 ， 那 么 滑 块 将 显示 两 头 的 值 和 滑 块 的 当前 只 
读 值 。 有 些 平 台 可 能 不 会 显示 当前 值 。 


wx.SL LEFT : 用 于 垂直 滑 块 ， 刻 度 位 于 滑 块 的 左边 。 


wx.SL RIGHT : 用 于 垂直 滑 块 ， 刻 度 位 于 滑 块 的 右边 。 

wx.SL TOP : 用 于 水 平滑 块 ， 刻 度 位 于 滑 块 的 上 部 。 

wx.SL_VERTICAL : 垂直 滑 块 。 

块 中 的 值 来 影响 你 的 应 用 程序 中 的 其 它 的 部 分 > 那么 这 儿 有 几 
你 可 使 用 的 事件 。 这 些 事件 与 窗口 滚动 条 所 发 出 的 是 相同 的 ， 详 细 的 说 明 参 见 第 

Apo 条 部 分 


表 7.10 列 出 了 你 可 用 于 滑 块 的 Set (1) 方 法。 每 个 Set () 方 法 都 有 一 个 对 应 
的 Get 方法 Get 方法 的 描述 参考 其 对 应 的 Set *() 方 法 。 


表 7.10 





GetRange() SetRange(minValue , maxValue) : 设置 滑 块 的 两 端 值 。 


GetTickFreq() SetTickFreq(n , pos) :使 用 参数 n 设 置 刻度 的 间隔 。 参 
Jk pos 没有 被 使 用 ， 但 是 它 仍然 是 必要 的 ， 将 它 设置 为 1。 


GetLineSize()  SetLineSize(lineSize) : 设置 你 每 按 一 下 方向 键 ， 滑 块 所 
增加 或 减少 的 值 。 


GetPageSize()  SetPageSize(pageSize) : 设置 你 每 按 一 
下 PgUp 或 PgDn 键 ， 滑 块 所 增加 或 减少 的 值 。 


GetValue()  SetValue(value) : 设置 滑 块 的 值 。 
尽管 滑 块 提供 了 一 个 可 能 范围 内 的 值 的 快速 的 可 视 化 的 表示 ， 但 是 它们 也 有 两 个 缺 


n 。 其 一 是 它们 占据 了 许多 的 空间 ， 另外 就 是 使 用 筷 标 精确 地 设置 滑 块 是 困难 的 。 
下 面 我 们 将 讨论 的 微调 控制 器 解决 了 上 面 的 这 两 个 问题 。 


如 何 得 到 那些 灵巧 的 上 下 箭头 按钮 ? 


微调 控制 器 是 文本 控件 和 一 对 箭头 按钮 的 组 合 ， 它 用 于 调整 数字 值 ， 并 且 在 你 要 求 
限度 的 屏幕 空间 的 时 候 ， 它 是 替代 滑 块 的 最 好 选择 。 图 7.8 显 示 
了 wxPython 的 微调 控制 器 控件 。 


图 7.8 
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Figure 7.8 
A spinner control 
in wxPython 


在 wxPython 中 ， 类 wx.SpinCtrl 管理 微调 按钮 和 相应 的 文本 显示 。 在 接 下 来 的 
部 分 ， 我 们 将 创建 一 个 微调 控制 器 。 


如 何 创建 一 个 微调 控制 器 


要 使 用 wx.SpinCtrl 来 改变 值 ， 可 通过 按 箭头 按钮 或 通过 在 文本 控件 中 输入 。 键 
入 的 非 数字 的 文本 将 被 忽略 ， 尺 管控 件 显示 的 是 键入 的 非 数 字 的 文本 。 一 个 超出 范 
的 值 将 被 认 作 是 相应 的 最 大 或 最 小 值 ， 尽 管 显示 的 是 你 输入 的 值 。 例 7.8 显 示 

了 wx.Spinctrl 的 用 法 。 


例 7.8 使 用 wx.Spinctrl 


import wx 


class SpinnerFrame(wx.Frame): 
def _ init (self): 
wx.Frame.__init__(self, None, -1, 'Spinner Example', 
size=(100, 100)) 
panel = wx.Panel(self, -1) 
sc = wx.SpinCtrl(panel, -1, "", (30, 20), (80, -1)) 
sc.SetRange(1, 100) 
sc.SetValue(5) 


if | name == ' main ': 
app - wx.PySimpleApp() 
SpinnerFrame().Show() 

app.MainLoop() 


几乎 微调 控件 所 有 复杂 的 东西 都 是 在 其 构造 函数 中 ， 其 构造 函数 如 下 : 


wx.SpinCtrl(parent , id =-1, value = wx.EmptyString 

pos = wx.DefaultPosition , size = wx.DefaultSize 

style = wx.SP_ARROW_KEYS , min =0, max =100, initial =0, 
name =" wxSpinCtrl ") 


参数 value 是 虚设 的 。 使 用 initial 参数 来 设置 该 控件 的 值 ， 并 使 
用 min 和 max 来 设置 该 控件 的 范围 。 


对 于 wx.Spinctrl 有 两 个 样式 标记 。 默 认 样 式 是 wx.SP ARROW KEYS ， 它 允许 
Al Pte L4] EF at KAR RTE 8048 9 XS wx.SP_WRAP 使 得 控件 中 的 
值 可 以 循环 改变 ， 也 就 是 说 你 通过 箭头 按钮 改变 控件 中 的 值 到 最 大 或 最 小 值 时 ， 如 
果 再 继续 ， 值 将 变 为 最 小 或 最 大 ， 从 一 个 极端 到 另 一 个 极端 。 你 也 可 以 捕 

jk EVT SPINCTRL 事件 ， 它 在 当 控件 的 值 改 变 时 产生 (即使 改变 是 直接 由 文本 输 
入 引起 的 ) 。 如 果 文 本 改变 了 ， 将 引发 一 个 EVT TEXT 事件 ， 就 如 同 你 使 用 一 个 单 
独 的 文本 控件 时 一 样 。 


如 例 7.8 所 示 ， 你 可 以 使 用 SetRange(minVal , maxVal) 和 
SetValue(value) 方法 来 设置 范围 和 值 。 SetValue() 函数 要 求 一 个 字符 串 或 
一 个 整数 。 要 得 到 值 ， 使 用 方法 : Getvalue() ( 它 返 回 一 个 整数 ) ， 
GetMin() ,和 GetMax() ° 


当 你 需要 对 微调 控制 器 的 行为 有 更 多 的 控制 时 ， 如 允许 浮 点 数 或 一 个 字符 串 的 列 
表 ， 你 可 以 把 一 个 wx.SpinButton 和 一 个 wx.Textctrl 放 到 一 起 ， 并 在 它们 之 
间 建 立 一 个 联系 。 然 后 捕获 来 自 wx.SpinButton 的 事件 ， 并 更 


新 wx.Textctrl 中 的 值 。 


如 何 生成 一 个 进度 条 ? 


如 果 你 只 想 图 形 化 地 显示 一 个 数字 值 而 不 允许 用 户 改 变 它 ， 那 么 使 用 相应 
的 wxPython 窗口 部 件 wx.Gauge » 相关 的 例子 就 是 图 7.9 所 显示 的 进度 条 。 


图 7.9 
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Figure 7.9 A wx.Gauge displaying 
some progress 


例 7.9 显 示 了 产生 图 7.9 的 代码 。 与 本 章 中 许多 别 的 例子 不 同 的 是 ， 这 里 我 们 增加 了 
一 个 事件 处 理 器 。 下 面 的 代码 在 空 闭 时 调整 标尺 的 值 ， 使 得 值 周而复始 的 变化 。 


例 7.9 显示 并 更 新 一 个 wx.Gauge 


import wx 


class GaugeFrame(wx.Frame) : 
def _ init (self): 
wx.Frame.__init__(self, None, -1, 'Gauge Example', 
size=(350, 150)) 
panel = wx.Panel(self, -1) 
self.count = 0 
self.gauge = wx.Gauge(panel, -1, 50, (20, 50), (250, 25) 


self .gauge.SetBezelFace(3) 
self .gauge.SetShadowwidth(3) 
self .Bind(wx.EVT_IDLE, self.OnIdle) 


def OnIdle(self, event): 
self.count = self.count + 1 
if self.count = 50: 
self.count = 0 
self .gauge.SetValue(self.count ) 
if _name__ == ' main ': 
app = wx.PySimpleApp( ) 
GaugeFrame( ).Show() 
app.MainLoop() 


wx.Gauge 的 构造 函数 类 似 于 其 它 的 数字 的 窗口 部 件 : 


wx.Gauge(parent , id , range , pos = wx.DefaultPosition , 
size = wx.DefaultSize , style = wx.GA_HORIZONTAL , 
validator = wx.DefaultValidator , name =" gauge ") 


当 你 使 用 参数 range 来 指定 数字 值 时 ， 该 值 代 表 标 尺 的 上 限 ， 而 下 限 总 是 0。 默 认 
样式 wx.GA HORIZONTAL 提供 了 一 个 水 平 条 。 要 将 它 旋 转 90 度 ， 使 

用 wx.GA VERTICAL i 如 果 你 是 在 Windows 上 ， su 

X wx.GA PROGRESSBAR 给 你 的 是 来 自 windows 工具 包 的 本 地 化 的 进 o 


作为 一 个 只 读 控 件 ， wx. Gauge 没有 事件 。 然 而 ， 它 的 属性 你 可 以 设置 。 你 可 以 使 
用 GetValue() , Set - Value(pos) , GetRange() ,和 SetRange(range) 来 
调整 它 的 值 和 范围 。 如 果 你 是 在 Windows 上 ， 并 且 没 有 使 用 本 地 进度 条 样式 ， 那 
么 你 可 以 使 用 SetBezelFace(width) and  SetShadowWidth() 来 改变 3D 效 果 
的 宽度 。 


给 用 户 以 选择 


几乎 每 个 应 用 程序 都 要 求 用 户 在 一 套 预 先 定义 的 选项 间 进 行 选择 。 
在 wxPython 中 ， 有 多 种 窗 NR a d ， 包 括 复 选 框 、 单 选 # 
钮 、 列 表 框 和 组 合 框 。 接 下 来 的 部 分 将 介绍 这 些 窗 口 部 件 。 


uy 


如 何 创 建 一 个 复 选 框 ? 

复 选 框 是 一 个 带 有 文本 标签 的 开关 按钮 。 复 选 框 通常 成 组 的 方式 显示 ， 但 是 每 个 复 
选 框 的 开关 状态 是 相互 独立 的 。 当 你 有 一 个 或 多 个 需要 明确 的 开关 状态 的 选项 时 ， 
可 以 使 用 复 选 框 。 图 7.10 显 示 了 一 组 复 选 框 。 


图 7.10 
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Figure 7.10 
A group of wxPython 
checkboxes 


在 wxPython 中 复 选 框 很 容易 使 用 。 它 们 是 wx.CheckBox 类 的 实例 ， 并 且 通 过 把 
它们 一 起 放 入 一 个 父 容器 中 可 以 让 它们 在 一 起 显示 。 例 7.10 提 供 了 生成 图 7.10 的 代 
Hs 


917.10 插入 三 个 复 选 框 到 一 个 框架 中 


import wx 


class CheckBoxFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, -1, 'Checkbox Example', 
size=(150, 200)) 
panel - wx.Panel(self, -1) 
wx.CheckBox(panel, -1, "Alpha", (35, 40), (150, 20)) 
wx.CheckBox(panel, -1, "Beta", (35, 60), (150, 20)) 
wx.CheckBox(panel, -1, "Gamma", (35, 80), (150, 20)) 
if | name == ' main ': 
app - wx.PySimpleApp() 
CheckBoxFrame( ) .Show( ) 
app.MainLoop() 


wx.CheckBox 有 一 个 典型 的 wxPython 构造 函数 : 


wx.CheckBox(parent , id , label , pos = wx.DefaultPosition , 
size = wx.DefaultSize , style =0, name =" checkBox ") 


label 参数 是 复 选 框 的 标签 文本 。 复 选 框 没有 样式 标记 ， 但 是 它们 产生 属于 自己 
的 独一无二 的 命令 事件 : EVT CHECKBOX ° wx.CheckBox 的 开关 状态 可 以 使 

用 GetValue() 和 SetValue(state) 方法 来 访问 ,并 且 其 值 是 一 个 布尔 

值 。 IsChecked() 方法 等 同 于 Getvalue() 方法 ， 只 是 为 了 让 代码 看 起 来 更 易 明 
白 。 


如 何 创 建 一 组 单 选 按钮 (radio 
button ) ? 


单 选 按钮 是 一 种 允许 用 户 从 几 个 选项 中 选择 其 一 的 窗口 部 件 。 与 复 选 框 不 同 ， 单 选 
按钮 是 显 式 地 成 组 配置 ， 并 且 只 能 选择 其 中 一 个 选项 。 当 选择 了 新 的 选项 时 ， 上 次 
的 选择 就 关闭 了 。 单 选 按钮 的 使 用 比 复 选 框 复杂 些 ， 因 为 它 需 要 被 组 织 到 一 组 中 以 
便 使 用 。 radio button 的 名 字 得 自 于 老式 轿车 上 有 着 同样 行为 的 成 组 的 选择 按 
$J o 


在 wxPython 中 ， 有 两 种 方法 可 以 创建 一 组 单 选 按钮 。 其 
一 ， wx.RadioButton ， 它 要 求 你 一 次 创建 一 个 按钮 ， 而 wx.RadioBox 使 你 可 
以 使 用 单一 对 得 来 配置 完整 的 一 组 按钮 ， 这 些 按钮 显示 在 一 个 矩形 中 。 


wx.RadioButton 类 更 简单 些 ， 在 单 选 按钮 对 其 它 窗口 部 件 有 直接 影响 或 单 选 
钮 不 是 布置 在 一 个 单一 的 矩形 中 的 情况 下 ， 它 是 首选 。 图 7.11 显 示 了 一 
组 wx.RadioButton 对 象 的 列子 。 


图 7.11 
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Figure 7.11 Example 
of wx.RadioButton 
where radio buttons 
enable text control 


我 们 在 这 个 例子 中 使 用 wx. RadioButton 的 原因 是 因为 每 个 单 选 按钮 控制 着 一 个 
关联 的 文本 控件 。 由 于 窗口 部 件 是 位 于 这 组 单 选 按钮 之 外 的 ， 所 以 我 们 不 能 只 用 一 
个 单 选 按钮 框 。 


如 何 创 建 单 选 按 鱼 
例 7.11 显 示 了 图 7.11 的 代码 ， 它 管理 单 选 按钮 和 文本 控件 之 间 的 联系 。 
例 7.11 使 用 wx.RadioButton 来 控制 另 一 个 窗口 部 件 


import wx 


class RadioButtonFrame(wx.Frame): 
def — init (self): 
wx.Frame. init (self, None, -1, 'Radio Example', 
size-(200, 200)) 
panel - wx.Panel(self, -1) 


# 创 建 单 选 按钮 


radio1 = wx.RadioButton(panel, -1, "Elmo", pos=(20, 50), 


style-wx.RB GROUP) 


radio2 - wx.RadioButton(panel, -1, "Ernie", pos-(20, 80) 


) 

radio3 - wx.RadioButton(panel, -1, "Bert", pos-(20, 110) 
) 
# 创 建文 本 控件 

text1 = wx.TextCtrl(panel, -1, "", pos=(80, 50)) 

text2 = wx.TextCtrl(panel, -1, "", pos=(80, 80)) 


text3 = wx.TextCtrl(panel, -1, "", pos=(80, 110)) 


self.texts = {"Elmo": texti, "Ernie": text2, 
t3}# 连 接 按钮 和 文本 
for eachText in [text2, text3]: 
eachText.Enable(False) 


"Bert": tex 


for eachRadio in [radioi, radio2, radio3]:4Z2pz #14} 
self.Bind(wx.EVT RADIOBUTTON, self.OnRadio, eachRadi 


0) 
self.selectedText = text1 


def OnRadio(self, event):# 事 件 处 理 器 
if self.selectedText: 
self.selectedText.Enable(False) 
radioSelected = event.GetEventObject() 
text - self.texts[radioSelected.GetLabel()] 
text.Enable(True) 
self.selectedText - text 


if | name == ' main ': 
app - wx.PySimpleApp() 
RadioButtonFrame().Show() 
app.MainLoop() 


我 们 创建 了 单 选 按钮 和 文本 框 ， 然 后 使 用 字典 来 建立 它们 间 的 连接 。 一 个 for fA 
环 使 得 两 个 文本 框 无 效 ， 另 一 个 for 循环 绑 定 单 选 按钮 命令 事件 。 当 事件 发 生 的 
时 候 ， 当 前 活动 的 文本 框 变 为 无 效 ， 与 被 项 击 的 按钮 相 匹 配 的 文本 框 变 为 有 效 。 


的 ， 如 下 所 示 : 


wx.RadioButton 的 使 用 类 似 于 是 wx.CheckBox ° E1149 4H RALF e748 FF] 


wx.RadioButton(parent , id , label , pos = wx.DefaultPosition , 
size = wx.DefaultSize , style =0, validator = wx.DefaultValidator , 


name -" radioButton ") 
ALR GRIEF > label 是 相应 按钮 的 显示 标签 。 


wx.RB GROUP 样式 声明 该 按钮 位 于 一 组 单 选 按钮 开头 。 一 组 单 选 按钮 的 定义 是 很 
重要 的 ， 因 为 它 控制 开关 行为 。 当 组 中 的 一 个 按钮 被 选中 时 ， 先 前 被 选中 的 按钮 被 
切换 到 未 选中 状态 。 在 一 个 单 选 按钮 使 用 wx.RB GROUP 被 创建 后 ， 所 有 后 来 的 被 
添加 到 相同 父 窗口 部 件 中 的 单 选 按钮 都 被 添加 到 同一 组 ， 直 到 另 一 单 选 按钮 使 
用 wx.RB GROUP 被 创建 ， 并 开始 下 一 个 组 。 在 例 7.11 中 ， 第 一 个 单 选 按钮 是 使 
用 wx.RB GROUP 声明 的 ， 而 后 来 的 没有 。 结 果 导 致 所 有 的 按钮 都 被 认为 在 同一 组 
中 ， 这 样 一 米 ， 敲 击 它们 中 的 一 个 时 ， 先 前 被 选中 按钮 将 关闭 。 


使 用 单 选 框 


通常 ， 如 果 你 想 去 显示 一 组 按钮 ， 分 别 声 明 它 们 不 是 最 好 的 方法 。 取 而 代 
Ž > wxPython 使 用 wx.RadioBox 类 让 你 能 够 创建 一 个 单一 的 对 象 ， 该 对 象 包 含 
了 完整 的 组 。 如 图 7.12 所 示 ， 它 看 起 来 非常 类 似 一 组 单 选 按钮 。 
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Figure 7.12 Two examples of 
wx.RadioBox built from the same 
underlying data with different 
configurations 


要 使 用 wx.RadioBox 类 ， 你 所 需要 的 全 部 就 是 构造 函数 。 例 7.12 显 示 了 图 7.12 的 
代码 。 


例 7.12 建造 单 选 框 


import wx 


class RadioBoxFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, -1, 'Radio Box Example', 
size=(350, 200)) 

panel - wx.Panel(self, -1) 

sampleList = ['zero', 'one', 'two', 'three', 'four', 'fi 
ve', 

'six', 'seven', 'eight'] 

wx.RadioBox(panel, -1, "A Radio Box", (10, 10), wx.Defau 

1tSize, 
sampleList, 2, wx.RA_SPECIFY_COLS) 


wx.RadioBox(panel, -1, "", (150, 10), wx.DefaultSize, 
sampleList, 3, wx.RA SPECIFY COLS | wx.N 
O. BORDER) 


if name == ' main . 
app - wx.PySimpleApp() 
RadioBoxFrame().Show() 

app.MainLoop() 


wx.RadioBox 的 构造 函数 比 简单 的 单 选 按钮 更 复杂 ， 因 为 你 需要 去 一 下 子 为 所 有 
的 按钮 指定 数据 ， 如 下 所 示 : 


wx.RadioBox(parent, id, label, pos=wx.DefaultPosition, 
size-wxDefaultSize, choices=None, majorDimension=0, 
style=wx.RA_SPECIFY_COLS, validator=wx.DefaultValidator, 
name="radioBox" ) 


label 参数 是 静态 文本 ， 它 显示 在 单 选 框 的 边框 上 。 这 些 按 钮 使 用 Choices # 
数 指定 ， 它 是 一 个 Python 的 字符 串 标 签 的 序列 。 


如 同 网 格 的 sizer 一 样 ， 你 通过 使 用 规定 一 个 维 数 的 尺寸 来 指 

定 wx.RadioBox 的 尺度 ，wxPython 在 另 一 维度 上 自动 填充 。 维 度 的 主 尺 寸 使 

用 majorDimension 参数 指定 。 哪 一 维 是 主要 的 由 样式 标记 决定 。 默 认 值 

是 wx.RA_SPECIFY_COLS 。 在 本 例 中 ， 左 框 的 列 数 被 设置 为 2， 右 框 的 列 数 被 设置 

> 行 数 由 choices 列表 中 的 元 素数 量 动态 的 决定 。 如 果 你 想得到 相反 的 行为 ， 
NAM Ses wx.RA_SPECIFY_ROWS 。 如 果 你 想 在 单 选 框 被 敲 击 时 响应 命令 

事件 ， 那么 命令 事件 是 EVT_RADIOBOX ° 


wx.RadioBox 类 有 许多 方法 来 管理 框 中 的 不 同 的 单 选 按钮 。 这 些 方 法 使 你 能 够 处 
a 内 部 按钮 ， 传递 该 按钮 的 索引 。 索引 以 0 为 开始 ， 并 按 严 格 的 顺序 展 
， 它 的 顺序 就 是 按钮 标签 传递 给 构造 函数 的 顺序 。 表 7.11 列 出 了 这 些 方法 。 


表 7.11 wx.RadioBox 的 方法 


EnableItem(n , flag) : flag 参数 是 一 个 布尔 值 ， 它 用 于 使 索引 为 n 的 按钮 
有 效 或 无 效 。 要 使 整个 框 立即 有 效 ， 使 用 Enable() ° 


FindString(string) : 根据 给 定 的 标签 返回 相关 按钮 的 整数 索引 值 ， 如 果 标 签 
没有 发 现 则 返回 -1 © 


Getcount() : 返回 框 中 按钮 的 数量 。 


GetItemLabel(n) SetItemLabel(n , string) : 返回 或 设置 索引 为 n 的 按钮 
的 字符 串 标签 。 


GetSelection()  GetStringSelection()  SetSelection(n) 
SetStringSelection( string) : GetSelection() 和 
SetSelection() 方法 处 理 当 前 所 选择 的 单 选 按 钮 的 整数 索 

引 。 GetStringSelection() 返回 当前 所 选择 的 按钮 的 字符 串 标 

签 ，SetStringSelection() 改变 所 选择 的 按钮 的 字符 串 标 签 为 给 定 值 。 没 
有 set *() 产 生 EVT RADIOBOX 事件 。 


ShowItem(item , show) : show 参数 是 一 个 布尔 值 ， 用 于 显示 或 隐藏 索引 
为 item 的 按钮 。 


单 选 按钮 不 是 给 用 户 一 系列 选择 的 唯一 方法 。 列 表 框 和 组 合 框 占 用 的 空间 也 少 ， 也 
可 以 被 配置 来 让 用 户 从 同一 组 中 作 多 个 选择 。 


如 何 创建 一 个 列表 框 ? 


列表 框 是 提供 给 用 户 选择 的 另 一 机 制 o 选项 被 放置 在 一 个 矩形 的 窗 口 中 用 户 可 以 
选择 一 个 或 多 as 9 列表 框 比 单 选 按钮 占据 较 少 的 空间 , 当选 项 的 数目 相对 少 的 时 
候 ， 列 表 框 是 一 个 好 的 选择 。 然 而 ， 如 果 用 户 必 须 将 滚动 条 拉 很 远 才 能 看 到 所 有 的 
选项 的 话 ， 那 么 它 的 效用 就 有 所 下 降 了 。 图 7.13 显 示 了 一 个 wxPython 列表 框 。 
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Figure 7.13 A wx.ListBox. 
with a simple list of options 


在 wxPython 中 ， 列 表 框 是 类 wx.ListBox 的 元 素 。 该 类 的 方法 使 你 能 够 处 理 列 
表 中 的 选择 。 


如 何 创 建 一 个 列表 框 
例 7.13 显 示 了 产生 图 7.13 的 代码 
例 7.13 使 用 wx.ListBox 


import wx 


class ListBoxFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, -1, 'List Box Example', 
size=(250, 200)) 
panel - wx.Panel(self, -1) 
sampleList = ['zero', 'one', 'two', 'three', 'four', 'fi 


ve', 


'six', 'seven', 'eight', 'nine', 'ten', 'e 


leven', 
'twelve', 'thirteen', 'fourteen'] 


listBox - wx.ListBox(panel, -1, (20, 20), (80, 120), sampleList, 


WX.LB SINGLE) 
listBox.SetSelection(3) 
if name == ' main ': 
app - wx.PySimpleApp() 
ListBoxFrame().Show() 
app.MainLoop() 


wx.ListBox 5854493& HRAMF E ETE > d PP: 


wx.ListBox(parent , id , pos - wx.DefaultPosition 
size = wx.DefaultSize , choices = None , style =0, 
validator - wx.DefaultValidator , name -" listBox ") 


3GEIEdeDDEJES]Ei €x wx.ListBox ZA label 属性 。 显 示 在 列表 中 的 元 
素 放 置 在 参数 choices 中 ， 它 是 一 个 字符 串 的 序列 。 列 表 框 有 三 种 互 斥 的 样式 ， 
它 决 定 用 户 如 何 从 列表 框 中 选择 元 素 ， 说 明 在 表 7.12 中 。 


用 户 通常 对 于 多 选 有 一 些 问题 ， 因 为 它们 一 般 希 望 见 到 的 是 单 选 列表 ， 对 于 多 选 来 
说 可 能 是 有 挑战 性 的 (就 像 单 选 题 和 多 选 题 一 样 ) ， 尤 其 是 对 于 那些 匈 受 困扰 的 用 
户 。 如 果 你 使 用 了 一 个 多 选 的 列表 ， 我 们 建议 你 清楚 地 标明 该 列表 。 


表 7.12 列表 框 的 选择 类 型 样式 


ue LB EXTENDED : 用 户 可 以 通过 使 用 shift 并 敲 击 和 鼠标 来 选择 一 定 范 围 内 的 连 
续 的 选项 ， 或 使 用 等 同 功能 的 按键 。 


wx.LB MULTIPLE : 用 户 可 以 一 次 选择 多 个 选项 (选项 可 以 是 不 连续 的 ) 。 实 际 
上 ， 在 这 种 情况 下 ， (5L RUEDA CEA — 组 复 选 框 。 


wx.LB_SINGLE : 用 户 一 次 只 能 选 一 个 选项 。 实 际 上 ， 在 这 种 情况 下 ， 列 表 框 的 
行为 就 像 是 一 组 单 先 先 按钮 。 


有 三 种 控制 wx. ListBox 中 滚动 条 的 显示 的 样式 ， 如 表 7.13 所 示 。 


表 7.13 列表 框 的 滚动 条 类 型 样式 
wX.LB ALWAYS SB : 列表 框 将 始终 显示 一 个 垂直 的 滚动 条 ， 不 管 有 没有 必要 。 


wx.LB_HSCROLL : 如 果 本 地 控 支 持 ， 那 么 列表 框 在 选择 项 太 多 时 ， 将 创建 一 个 水 
TRAE 


wx.LB HSCROLL : 列表 框 只 在 需要 的 时 候 显示 一 个 垂直 的 滚动 条 。 这 是 默认 样 
Ñ 。 


还 有 一 个 样式 wx.LB SORT ， 它 使 得 列表 中 的 元 素 按 字母 顺序 排序 。 


有 两 个 专用 于 wx,ListBox 的 命令 事件 。 EVT LISTBOX 事件 在 当 列 表 中 的 一 个 元 
素 被 选择 时 触发 (即使 它 是 当前 所 选择 的 元 素 ) 。 如 果 列 表 被 双 
击 ， EVT_LISTBOX_DCLICK 事件 发 生 。 


有 一 些 专用 于 列表 框 的 方法 ， 你 可 以 用 来 处 理 框 中 的 项 目 。 表 7.14 对 许多 的 方法 作 
了 说 明 。 列 表 框 中 的 项 目 索引 从 0 开始 。 


一 旦 你 有 了 一 个 列表 框 ， 自 然 就 想 把 它 与 其 它 的 窗口 部 件 结合 起 来 使 用 ， 如 下 拉 菜 
单 ， 或 复 选 框 。 在 下 一 节 ， 我 们 对 此 作 讨 论 。 


表 7.14 列表 框 的 方法 

Append(item) : 把 字符 串 项 目 添 加 到 列表 框 的 尾部 。 
Clear() :清空 列表 框 。 

Delete(n) : 删除 列表 框 中 索引 为 n 的 项 目 。 


Deselect(n) :在 多 重 选择 列表 框 中 ， 导 致 位 于 位 置 n 的 选项 取消 选中 。 在 其 它 
样式 中 不 起 作用 。 

FindString(string) :返回 给 定 字符 串 的 整数 位 置 ， 如 果 没 有 发 现 则 返回 -1。 
GetCount() : 返回 列表 中 字符 串 的 数量 。 

GetSelection() SetSelection(n , select)  GetStringSelection() 
SetStringSelection(string , select) 

GetSelections() : GetSelection() 得 到 当前 选择 项 的 整数 索引 ( 仅 对 于 单 
选 列 表 ) 。 对 于 多 选 列 表 ， 使 用 Getselections() 来 返回 包含 所 选项 目的 整数 位 
置 的 元 组 。 对 于 单 选 列 表 ， Getstringselection() 返回 当前 选择 的 字符 串 。 相 
应 的 set 方法 使 用 布尔 值 参数 select 设置 指定 字符 串 或 索引 选项 的 状态 。 使 用 
这 种 方法 改变 选择 不 触发 EVT_LISTBOX 事件 。 


GetString(n) SetString(n , string) :得 到 或 设置 位 置 n 处 的 字符 串 。 


InsertItems(items , pos) :插入 参数 items 中 的 字符 串 列表 到 该 列表 框 
中 pos 参数 所 指定 的 位 置 前 。 位 置 0 表示 把 项 目 放 在 列表 的 开头 。 


Selected(n) : 返回 对 应 于 索引 为 n 的 项 目的 选择 状态 的 布尔 值 。 


Set(choices) : 重新 使 用 choices 的 内 容 设置 列表 框 。 


如 何 合 并 复 选 框 和 列表 框 ? 


你 可 以 使 用 类 wx.CheckListBox 来 将 复 选 框 与 列表 框 合并 。 图 7.14 显 示 了 列表 框 
和 复 选 框 在 合并 在 一 起 的 例子 。 


图 7.14 


— Check BoxE [aE 

















Figure 7.14 A check list 
box is very similar to a 
regular list box 


wx.CheckListBox “#422 BAA KSRAKA wx. ListBox 的 相同 。 它 有 一 个 
新 的 事件 : wx.EVT. CHECKLISTBOX ， 它 在 当 列 表 中 的 一 个 复 选 框 被 融 击 时 触发 。 
它 有 两 个 管理 复 选 框 的 新 的 方法 : Check(n , check) 设置 索引 为 n 的 项 目的 选择 
状态 ， IsChecked(item) 在 给 定 的 索引 的 项 目 是 选中 状态 时 返回 True 。 


如 果 我 想 要 下 拉 形 式 的 选择 该 怎么 做 ? 


下 拉 式 选择 是 一 种 仅 当下 拉 箭 头 被 敲 击 时 才 显 示 选 项 的 选择 机 制 。 它 是 显示 所 选 元 
素 的 最 简洁 的 方法 ， 当 屏幕 空间 很 有 限 的 时 候 ， 它 是 最 有 用 的 。 图 7.15 显 示 了 一 个 
关闭 的 下 拉 式 选择 。 图 7.16 显 示 了 一 个 打开 的 下 拉 式 选择 。 























图 7.15 
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Figure 7.15 
A pull-down 
choice, with 
no selection 
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Figure 7.16 


A pull-down choice 
in the process of 
having an element 
selected 























下 拉 式 选择 的 使 用 与 标准 的 列表 框 是 很 相似 的 。 例 7.14 显 示 了 如 何 创建 一 个 下 拉 式 
选择 。 


例 7.14 


import wx 


class ChoiceFrame(wx.Frame): 
def _init_ (self): 
wx.Frame.__init__(self, None, -1, 'Choice Example', 
size=(250, 200)) 
panel - wx.Panel(self, -1) 
sampleList = ['zero', 'one', 'two', 'three', 'four', 'fi 


ve', 
'six', 'seven', 'eight'] 
wx.StaticText(panel, -1, "Select one:", (15, 20)) 
wx.Choice(panel, -1, (85, 18), choices=sampleList) 
if _name__ == ' main ': 


app = wx.PySimpleApp() 
ChoiceFrame().Show() 
app.MainLoop() 


wx.Choice 的 构造 函数 与 列表 框 的 基本 相同 : 


wx.Choice(parent , id , pos = wx.DefaultPosition 
size = wx.DefaultSize , choices = None , style =0, 


validator - wx.DefaultValidator , name -" choice ") 


wx.Choice 没有 专门 的 样式 ， 但 是 它 有 独特 的 命令 事件 : EVT CHOICE 。 几 乎 表 
7.14 中 所 有 适用 于 单 选 列 表 框 的 方法 都 适用 于 wx.Choice 对 象 。 


我 能 够 将 文本 域 与 列表 合并 在 一 起 吗 ? 


将 文本 域 与 列表 合并 在 一 起 的 窗口 部 件 称 为 组 合 框 ， 其 本 质 上 是 一 个 下 拉 选 择 和 文 
本 框 的 组 合 。 图 7.17 显 示 了 一 个 组 合 框 。 


图 7.17 左边 是 wx,CB_DropDOWN 样式 ， 右 边 是 wx.CB SIMPLE 样式 
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Figure 7.17 Acombo box showing the 
left box in the style wx. CB DROPDOWN, 
and the right in wx. CB SIMPLE 


在 Windows 上 ， 你 可 以 使 用 右边 的 样式 ， 它 是 一 个 列表 框 和 文本 框 的 组 合 。 


创建 组 合 框 的 代码 与 我 们 已 经 见 过 的 选择 是 类 似 的 。 该 类 是 wx.ComboBox ， 它 
是 wx.Choice 的 一 个 子 类 。 例 7.15 显 示 了 图 7.17 的 代码 : 


例 7.15 


import wx 


class ComboBoxFrame(wx.Frame): 
def — init (self): 
wx.Frame.__init__(self, None, -1, 'Combo Box Example', 
size-(350, 300)) 
panel - wx.Panel(self, -1) 
sampleList = ['zero', 'one', 'two', 'three', 'four', 'fi 
ve', 
'six', 'seven', 'eight'] 
wx.StaticText(panel, -1, "Select one:", (15, 15)) 
wx.ComboBox(panel, -1, "default value", (15, 30), wx.Def 
aultSize, 
sampleList, wx.CB DropDOWN) 
wx.ComboBox(panel, -1, "default value", (150, 30), wx.De 
faultSize, 
sampleList, wx.CB SIMPLE) 
if | name == ' main ': 
app - wx.PySimpleApp() 
ComboBoxFrame( ).Show( ) 
app.MainLoop() 


wx.ComboBox 的 构造 函数 如 下 所 示 : 


wx.ComboBox(parent, id, value="", pos=wx.DefaultPosition, 
size=wx.DefaultSize, choices, style=0, 
validator=wx.DefaultValidator, name="comboBox" ) 


对 于 wx.ComboBox 来 说 有 4 种 样式 。 其 中 的 两 种 决定 了 如 何 绘制 组 合 

框 : wx.CB DropDOWN 创建 一 个 带 有 下 拉 列 表 的 组 合 框 ， wx.CB SIMPLE 创建 一 
个 带 有 列表 框 的 组 合 框 。 在 Windows 上 你 可 以 只 使 用 wx.CB SIMPLE 样式 。 任 何 
组 合 框 都 可 以 被 指定 为 wx.CB READONLY 样式 ， 它 防止 用 户 在 文本 域 中 键入 。 当 
组 合 框 被 指定 为 只 读 时 ， 所 做 的 选择 必须 来 自 于 选择 列表 的 元 素 之 一 ， 即 使 你 用 程 
序 来 设置 它 也 不 行 。 最 后 wx .CB_SORT 样式 导致 选择 列表 中 的 元 素 按 字母 顺序 显 
R e 

由 于 wx.ComboBox 是 wx.Choice 的 子 类 ， 所 有 的 wx.Choice 的 方法 都 能 被 组 


合 框 调用 ， 如 表 7.14 所 示 。 另 外 ， 还 有 许多 方法 被 定义 来 处 理 文本 组 件 ， 它 们 的 行 
为 同 wx.Textctrl (参见 表 7.4)， 所 定义 的 方法 有 Copy() , Cut() ， 


GetInsertionPoint() , GetValue() , Paste() , Replace(from , to , 
text) , Remove(from , to) , SetInsertionPoint(pos) , 
SetInsertionPointEnd() ,和 SetValue() ° 


本 章 小 结 


在 这 一 章 中 ， 我 们 给 你 展示 了 如 何 使 用 wxPython 中 许多 最 基本 和 常用 的 控件 。 这 
些 通用 的 版 本 在 跨 平台 使 用 时 显得 一 致 性 较 好 。 


1、 对 于 静态 文本 标签 的 显示 ， 你 可 以 使 用 wx.StaticText 类 。 还 有 一 个 完全 
用 wxPython 实现 的 版 本 ， 名 为 wx.lib.stattext.GenStaticText 。 


2、 如 果 你 需要 一 个 控件 以 让 用 户 输 入 文本 ， 那 么 使 用 类 wx.Textctrl 。 它 允许 
单行 和 多 行 的 输入 ， 还 有 密码 掩饰 和 其 它 的 功用 。 如 果 本 地 控 支持 它 ， 你 可 以 使 
用 wx.TextCtrl 来 得 到 样式 文本 。 样 式 是 wx.Text - Attr 类 的 实 

f|* wx.Font 包含 字体 信息 。 对 于 所 有 的 系统 ， 你 可 以 使 用 

类 wx.stc.StyledTextCtrl (= wxPython 对 开源 Scintilla 文本 组 件 的 
封装 ) 在 一 个 可 编辑 的 文本 组 件 中 实现 颜色 和 字体 样式 。 


3、 创 建 按钮 ， 使 用 wx.Button 类 ， 它 也 有 一 个 通用 
版 wx.lib.buttons.GenButton ° 按钮 可 以 使 用 位 图 来 代替 一 个 文本 标签 

( wx.BitmapButton ) ， 或 在 按 下 和 未 按 下 之 间 有 一 个 开关 状态 。 还 有 一 个 等 价 
于 位 图 和 开关 按钮 的 通用 版 ， 它 比 标准 版 有 更 全 面 的 特性 。 


4、 有 一 些 方法 用 于 选择 或 显示 数字 值 。 你 可 以 使 用 wx.Slider 类 来 显示 一 个 垂 
直 或 水 平 的 滑 块 。 wx.SpinCtrl 显示 一 个 可 以 使 用 上 下 按钮 来 改变 数字 值 的 文本 
控件 。 wx.Gauge 控件 显示 一 个 进度 条 指示 器 。 


5、 你 可 以 从 一 系列 的 控件 中 选 出 让 用 户 从 列表 选项 作出 选择 的 最 佳 控件 ， 最 佳 控 
件 所 应 考虑 的 条 件 是 选项 的 数量 ， 用 户 能 否 多 选 和 你 想 使 用 的 屏幕 空间 的 总 量 。 复 
选 框 使 用 wx.CheckBox 类 。 这 儿 有 两 个 方法 去 得 到 单 选 按 

钮 : wx.RadioButton 给 出 单个 单 选 按 钮 ， 而 wx.RadioBox 给 出 显示 在 一 起 的 

一 组 按钮 。 这 儿 有 几 个 列表 显示 控件 ， 它 们 的 用 法 相似 。 列 表 框 的 创建 使 

用 wx.ListBox ， 并 且 你 可 以 使 用 wx.CheckListBox Ñ% J X Xt&JE o xp $ fü 

洁 的 下 拉 式 ， 使 用 wx.Choice. wx.ComboBox 合并 了 列表 和 文本 控件 的 特性 。 


到 目前 为 止 ， 我 们 已 经 涉及 了 基本 的 常用 窗口 部 件 ， 在 接 下 来 的 章节 ， 我 们 将 讨论 
不 同 种 类 的 框架 ， 它 可 以 用 这 些 框架 来 包含 我 们 已 经 涉及 了 基本 的 常用 窗口 部 件 。 


第 八 草 将 构件 放 入 窗 体 中 


1. 把 窗口 部 件 放 入 框架 中 
ij， 框架 的 寿命 
ii， 使 用 框架 
ii， 可 选 的 框架 类 型 
iv. 使 用 分 割 窗 
v. 本 章 小 结 


在 你 的 wxPython 中 ， 所 有 的 用 户 交 互 行为 都 发 生 在 一 个 窗口 部 件 容 器 中 ， 它 通常 被 
称 作 窗口 ， 在 wxPython 中 被 称 为 框架 。 在 这 一 章 中 ， 我 们 将 讨论 wxPython 中 的 几 
个 不 同样 式 的 框架 。 这 个 主要 的 wx.Frame 有 几 个 不 同 的 框架 样式 ， 这 些 样 式 可 以 改 
变 wx.Frame 的 外 观 。 另 外 ，wxPython 提 供 了 小 型 框架 和 实现 多 文档 界面 的 框架 。 
框架 可 以 使 用 分 隔 条 来 划分 为 不 同 的 部 分 ， 并 且 可 以 通过 滚动 条 的 使 用 来 包含 比 杠 
架 本 身 大 的 面板 (panel) 。 


框架 的 寿命 


我 们 将 通过 讨论 框架 最 基本 的 元 素 : 创建 和 除去 它们 ， 来 作为 我 们 的 开始 。 创 建 框 
架 包括 了 解 可 以 应 用 的 所 有 样式 元 素 ; 框架 的 去 除 可 能 比 你 原本 想像 的 要 复杂 。 


如 何 创 建 一 个 框架 ? 


在 本 书 中 我 们 已 经 见 过 了 许多 的 框架 创建 的 例子 ， 但 是 我 们 仍 将 再 回顾 一 下 框架 创 
建 的 初步 原则 。 


创建 一 个 简单 的 框架 
框架 是 类 Wx.Frame 的 实例 。 例 8.1 显 示 了 一 个 非常 简单 的 框架 创建 的 例子 。 
例 8.1 创建 基本 的 wx.Frame 


import wx 


if _name__ == ' main ': 
app = wx.PySimpleApp() 
frame = wx.Frame(None, -1, "A Frame", style=wx.DEFAULT_FRAME 
_STYLE, 
size=(200, 100)) 
frame.Show() 
app.MainLoop() 


上 面 的 代码 创建 一 个 带 有 标题 的 框架 ， 其 大 小 是 (200,100)。 表 8.1 中 的 默认 样式 提 
供 了 标准 框架 的 装饰 如 关闭 框 、 最 小 化 和 最 大 化 框 。 结 果 如 图 8.1 所 示 。 


图 8.1 
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Figure 8.1 
The simple frame 


wx.Frame 的 构造 函数 类 似 于 我 们 在 第 7 章 见 到 的 其 它 窗 口 部 件 的 构造 函数 : 


wx.Frame(parent, id=-1, title="", pos=wx.DefaultPosition, 
size=wx.DefaultSize, style=wx.DEFAULT_FRAME_STYLE, 
name="frame" ) 


这 里 有 超过 十 余 种 之 多 的 专用 于 wx.Frame 的 样式 标记 ， 我 们 将 在 下 一 部 分 涵盖 它 
们 。 上 默认 样式 为 你 提供 了 最 小 化 和 最 大 化 框 、 系 统 下 拉 菜 单 、 可 调整 尺寸 的 粗 边框 
和 一 个 标题 。 


这 里 没有 与 一 个 wx.Frame 挂 钧 的 事件 类 型 。 但 是 ， 由 于 一 个 wx.Frame 是 你 的 屏幕 
上 用 户 最 可 能 去 关闭 的 元 素 ， 所 以 你 通常 想 去 为 关闭 事件 定义 一 个 处 理 器 ， 以 便 子 
窗口 和 数据 被 妥善 的 处 理 。 


创建 框架 的 子 类 


你 将 很 少 直 接 创建 wx.Frame 的 实例 。 正 如 我 们 在 本 书 中 所 见 过 的 其 它 例子 一 样 ， 一 
个 典型 的 wxPython 应 用 程序 创建 Wwx.Frame 的 子 类 并 创建 那些 子 类 的 实例 。 这 是 因 
为 WX.Frame 的 独特 的 情形 虽然 它 自身 定义 了 很 少 的 行为 ， 但 是 带 有 独自 的 初始 
化 程序 的 子 类 是 放置 有 关 你 的 框架 的 布局 和 行为 的 最 合理 的 地 方 。 不 创建 子 类 而 构 
造 你 应 用 程序 的 特定 的 布局 是 有 可 能 ， 但 除了 最 简单 的 应 用 程序 以 外 ， 那 是 不 容易 
的 。 例 8.2 展 示 了 wx.Frame 子 类 的 例子 。 


例 8.2 一 个 简单 的 框架 子 类 





import wx 


class SubclassFrame(wx.Frame): 
def _ init (self): 
wx.Frame.__init__(self, None, -1, 'Frame Subclass', 
size-(300, 100)) 

panel - wx.Panel(self, -1) 
button = wx.Button(panel, -1, "Close Me", pos=(15, 15)) 
self.Bind(wx.EVT BUTTON, self.OnCloseMe, button) 
self.Bind(wx.EVT CLOSE, self.OnCloseWindow) 


def OnCloseMe(self, event): 
self.Close(True) 


def OnCloseWindow(self, event): 
self.Destroy() 
if name == ' main ': 
app - wx.PySimpleApp() 
SubclassFrame().Show() 
app.MainLoop() 








运行 结果 如 图 8.2 所 示 
图 8.2 
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Figure 8.2 The simple frame as 
a subclass 


我 们 在 许多 其 它 的 例子 中 已 经 见 过 了 这 种 基本 的 结构 ， 因 此 让 我 们 来 讨论 上 面 代码 
中 特定 于 框架 的 部 分 。wx.Frame.init 方 法 与 Wx.Frame 构 造 函 数 有 相同 的 信息 。 子 类 
自身 的 构造 器 除了 self 没 有 其 它 参数 ， 它 允许 你 作为 程序 员 去 定义 参数 ， 所 定义 的 
参数 将 传递 给 其 父 类 ， 并 且 使 你 可 以 不 用 重复 指定 与 父 类 相同 的 参数 。 


同样 值得 注意 的 是 ， 框 架 的 子 窗 口 部 件 被 放置 在 一 个 面板 (panel) Po DR 
(panel) 是 类 wx.Panel 的 实例 ， 它 是 其 它 有 较 少 功能 的 窗口 部 件 的 容器 。 你 基本 上 
应 该 使 用 一 个 wx.Panel 作 为 你 的 框架 的 顶级 子 窗口 部 件 。 有 一 件 事情 就 是 ， 多 层次 
的 构造 可 以 使 得 更 多 的 代码 能 够 重用 ， 如 相同 的 面板 和 布局 可 以 被 用 于 多 个 框架 
中 。 在 框架 中 使 用 wx.Panel 给 了 你 一 些 对 话 框 的 功能 。 这 些 功 能 以 成 对 的 方式 表 
现 。 其 一 是 ， 在 MS Windows 操 作 系 统 下 ，wx.Panel 实 例 的 默认 背景 色 以 白色 代替 
了 灰色 。 其 二 ， 面 板 (panel) 可 以 有 一 个 默认 的 项 目 ， 该 项 目 在 当 回 车 键 被 按 下 
时 自动 激活 ， 并 且 面 板 (panel) 以 与 对 话 框 大 致 相同 的 办 法 响应 tab 键 盘 事 件 ， 以 
改变 或 选择 默认 项 目 。 


有 些 什 么 不 同 的 框架 样式 ? 


Wx.Frame 有 许多 的 可 能 的 样式 标记 。 通 常 ， 默 认 样式 就 是 你 想 要 的 ， 但 也 有 一 些 有 
用 的 变种 。 我 们 将 讨论 的 第 一 组 样式 控制 框架 的 形状 和 尺寸 。 尽 管 不 是 强制 性 的 ， 
但 是 这 些 标 记 应 该 被 认为 是 互 斤 的 一 个 给 定 的 框架 应 该 只 使 用 它们 中 的 一 个 。 
表 8.1 说 明了 形状 和 尺寸 标记 。 


表 8.1 框架 的 形状 和 尺寸 标记 





一 个 完全 标准 的 框架 ， 除 了 一 件 事 : 在 
Windows 系 统 和 别 的 支持 这 个 特性 的 系统 下 ， 
它 不 显示 在 任务 栏 中 。 当 最 小 化 时 ， 该 框架 图 
标 化 到 桌面 而 非 任 务 栏 。 
非 矩 形 的 框架 。 框 架 的 确切 形状 使 
wx.FRAME_SHAPED 用 SetShape() 方 法 来 设置 。 窗 口 的 形状 将 在 本 
章 后 面部 分 讨论 。 
该 框架 的 标题 栏 比 标准 的 小 些 ， 通 常用 于 包含 
wx.FRAME_TOOL_WINDOW ， 多 种 工具 按钮 的 辅助 框架 。 在 Windows 操 作 系 
统 下 ， 工 具 窗口 将 不 显示 在 任务 栏 中 。 


窗口 初始 时 将 被 最 小 化 显示 。 这 个 样式 仅 在 


wx.FRAME_NO_TASKBAR 


wx.ICONIZE Windows Å 2% P 3e 4f M » 

窗口 初始 时 将 被 最 大 化 显示 (RR) 。 这 个 样 
wx.MAXIMIZE 3 bk Windows & A d 3e4£ FA » 
wX. MINIMIZE F|wx.ICONIZE ° 


上 面 这 组 样式 中 ， 屏 幕 画面 最 需要 的 样式 是 wx.FRAME_TOOL WINDOW ° 418.3 
显示 了 一 个 小 的 结合 使 用 了 wx.FRAME_TOOL _ WINDOW、wx.CAPTION 和 
wx.SYSTEM_MENU 样 式 的 例子 。 


图 8.3 


Figure 8.3 An example of the 
tool window style 


这 里 有 两 个 互 不 的 样式 ， 它 们 控制 一 个 框架 是 否 位 于 别 的 框架 的 上 面 ， 无 论 别 的 框 
架 是 否 获得 了 焦点 。 这 对 于 那些 小 的 不 是 始终 可 见 的 对 话 框 是 有 用 的 。 表 8.2 说 明了 
这 两 个 样式 。 最 后 ， 这 还 有 一 些 用 于 放置 在 你 的 窗口 上 的 装饰 。 如 果 你 没有 使 用 默 
认 样 式 ， 那 么 这 些 装 饰 将 不 被 自动 放置 到 你 的 窗口 上 ， 你 必须 添加 它们 ， 否 则 容 多 
导致 窗口 不 能 关闭 或 移动 。 表 8.3 给 出 了 这 些 装饰 的 列表 。 


表 8.2 针对 窗口 漂浮 行为 的 样式 








框架 将 漂浮 在 其 父 窗口 ( 仅 其 父 窗口 ) 的 
上 面 。 (很 明显 ， 要 使 用 这 个 样式 ， 框 架 
需要 有 一 个 父 窗口 ) 。 其 它 的 框架 可 以 让 
盖 这 个 框架 。 


该 框架 将 始终 在 系统 中 其 它 框架 的 上 面 。 
(如 果 你 有 多 个 框架 使 用 了 这 个 样式 ， 那 
么 它们 将 相互 重合 ， 但 对 于 系统 中 其 它 的 
框架 ， 它 们 仍 在 上 面 。) 


wx.FRAME_FLOAT_ON_PARENT 


wx.STAY_ON_TOP 


默认 的 样式 wx.DEFAULT_FRAME_STYLE 等 同 于 wx.MINIMIZE_BOX | 
wx.MAXIMIZE BOX | wx.CLOSE_BOX | wx.RESIZE BORDER | 

wx.SYSTEM MENU |wx.CAPTION。 这 个 样式 创建 了 一 个 典型 的 窗口 ， 你 可 以 调 
整 大 小 ， 最 小 化 ， 最 大 化 ， 或 关闭 。 一 个 很 好 的 主意 就 是 当 你 想 要 使 用 除 默认 样式 
以 外 的 样式 时 ， 将 默认 样式 与 其 它 的 样式 组 合 在 一 起 ， 以 确保 你 有 正确 的 一 套装 
饰 。 例 如 ， 要 创建 一 个 工具 框架 ， 你 可 以 使 用 style=wx.DEFAULT_FRAME_STYLE 
| wx.FRAME_TOOL_WINDOW 。 记 住 ， 你 可 以 使 用 ^ 操 作 符 来 去 掉 不 要 的 样式 。 


表 8.3 用 于 装饰 窗口 的 样式 


给 窗口 一 个 标题 栏 。 如 果 你 要 放置 最 大 化 
wx.CAPTION 框 、 最 小 化 框 、 系 统 菜单 和 上 下 文 帮助 ， 
那么 你 必须 包括 该 样式 。 


这 是 用 于 Windows 操 作 系 统 的 ， 它 在 标题 
栏 的 右 角 放置 问号 帮助 图 标 。 这 个 样式 是 
与 Wx.MAXIMIZE_BOX 和 
WX.MINIMIZE_BOX## A Z Jf a9 o X — 
个 扩展 的 样式 ， 并 且 必 须 使 用 两 步 来 创 
建 ， 稍 后 说 明 。 


在 Mac OS X 上 ， 使 用 这 个 样式 的 框架 有 


wx.FRAME_EX_CONTEXTHELP 


wx.FRAME_EX_METAL 一 个 金属 质感 的 外 观 。 这 是 一 个 附加 样 
式 ， 必 须 使 用 SetExtraStyle 方 法 来 设置 。 

wx.MAXIMIZE_BOX 在 标题 栏 的 标准 位 置 放 置 一 个 最 大 化 框 。 

wx.MINIMIZE_BOX 在 标题 栏 的 标准 位 置 放 置 一 个 最 小 化 框 。 

wx.CLOSE_BOX 在 标题 栏 的 标准 位 置 放置 一 个 关闭 框 。 
给 框架 一 个 标准 的 可 VV aye x R +442 

wx.RESIZE_ BORDER ~ MAR 2E S T AF ER T 8338 
给 框架 一 个 最 简单 的 边框 ， 不 能 调整 尺 

wx.SIMPLE_BORDER 寸 ， 没 有 其 它 装饰 。 该 样式 与 所 有 其 它 装 
饰 样式 是 互 斥 的 


在 标题 栏 上 放置 一 个 系统 菜单 。 这 个 系统 
菜单 的 内 容 与 你 所 使 用 的 装饰 样式 有 关 。 
例如 ， 如 果 你 使 用 wx.MINIMIZE_BOX : 
那么 系统 菜单 项 就 有 "最 小 化 "选项 。 


wx.SYSTEM_MENU 


如 何 创建 一 个 有 额外 样式 信息 的 框架 ? 


wx.FRAME_EX_CONTEXTHELP 是 一 个 扩展 样式 ， 意 思 是 样式 标记 的 值 太 大 以 致 
于 不 能 使 用 通常 的 构造 函数 来 设置 〈 因 为 底层 C++ 变量 类 型 的 特殊 限制 ) 。 通 常 你 
可 以 在 窗口 部 件 被 创建 后 ， 使 用 SetExtraStyle 方 法 来 设置 额外 的 样式 ， 但 是 某 些 样 
式 ， 比 如 Wx.FRAME EX _CONTEXTHELP， 必 须 在 本 地 UI (用 户 界面 ) 对 象 被 创 
建 之 前 被 设置 。 在 wxPython 中 ， 这 需要 使 用 稍微 策 抽 的 方法 来 完成 ， 即 分 两 步 构 
建 。 之 后 标题 栏 中 带 有 我 们 熟悉 的 问号 图 标的 框架 就 被 创建 了 。 如 图 8.4 所 示 。 


图 8.4 





elp Context 


Figure 8.4 Aframe with the 
extended context help enabled 





标记 值 必 须 使 用 SetExtraStyle() 方 法 来 设置 。 有 时 ， 额 外 样式 信息 必须 在 框架 被 实 
例 化 前 被 设置 ， 这 就 导致 了 一 个 问题 : 你 如 何 对 于 一 个 不 存在 的 实例 调用 一 个 方 
法 ?在 接 下 来 的 部 分 ， 我 们 将 展示 实现 这 种 操作 的 两 个 机 制 。 


添加 额外 样式 信息 


在 wxPython 中 ， 额 外 样式 信息 在 创建 之 前 通过 使 用 专门 的 类 wx.PreFrame 来 被 添 
加 ， 它 是 框架 的 一 种 局 部 实例 。 你 可 以 在 预 框架 (preframe) 上 设置 额外 样式 位 ， 
然后 使 用 这 个 预 框架 (preframe ) 来 创建 实际 的 框架 。 例 8.3 显 示 了 在 一 个 子 类 的 构 
造 器 中 如 何 完 成 这 两 步 (two-step) 的 构建 。 注 意 ， 在 wxPython 中 它 实际 上 是 三 步 
(在 C++ wxWidgets 工 具 包 中 ， 它 是 两 步 (two-step) ， 我 们 只 是 沿用 这 个 叫 法 而 
e)» 


118.3 


import wx 
class HelpFrame(wx.Frame): 


def _init_ (self): 
pre = wx.PreFrame() #1 预 构建 对 象 
pre.SetExtraStyle(wx.FRAME_EX_CONTEXTHELP ) 
pre.Create(None, -1, "Help Context", size=(300, 100), 
style-wx.DEFAULT FRAME STYLE ^ 
(wx.MINIMIZE BOX | wx.MAXIMIZE BOX)) #2 创建 框架 
self.PostCreate(pre) #3 底层 C++ 指针 的 传递 


if name == ' main ': 
app - wx.PySimpleApp() 
HelpFrame().Show() 
app.MainLoop() 


#1 创建 Wx.PreFrame() 的 一 个 实例 (关于 对 话 框 ， 这 有 一 个 类 似 的 wx.PreDialog() 
一 一 其 它 的 wxWidgets 窗 口 部 件 有 它们 自己 的 预 类 ) 。 在 这 个 调用 之 后 ， 你 可 以 做 
你 需要 的 其 它 初始 化 工作 。 


#2 调用 Create() 方 法 创建 框架 。 


#3 这 是 特定 于 WxPython 的 ， 并 且 不 由 C++ 完成 。PostCreate 方 法 做 一 些 内 部 的 内 
务 处 理 ， 它 实例 化 一 个 你 在 第 一 步 中 创建 的 封装 了 C++ 的 对 象 。 


添加 额外 样式 信息 的 通用 方法 


先前 的 算法 有 点 笨拙 ， 但 是 它 可 以 被 重 构 得 容易 一 点 ， 以 便于 管理 维护 。 第 一 步 是 
创建 一 个 公用 函数 ， 它 可 以 管理 任何 分 两 步 的 创建 。 例 8.4 提 供 了 一 个 例子 ， 它 使 用 
Python 的 内 省 性 能 来 调用 以 变量 形式 被 传递 的 子 数 。 这 个 例子 用 于 在 Python 的 一 个 
新 的 框架 实例 化 期 间 的 init 方 法 中 被 调用 。 


例 8.4 一 个 公用 的 两 步 式 创建 函数 


def twoStepCreate(instance, preClass, preInitFunc, *args, **kwarg 
s): 

pre = preClass() 

preInitFunc(pre) 

pre.Create(*args, **kwargs) 

instance.PostCreate(pre) 


4E 18.4 P. > HRREREPLAHEKS o instance ZÆ 3: RIRA EH FH o 
preClass 参 数 是 临时 的 预 类 的 类 对 象 对 框架 预 类 是 wx.PreFrame。prelnitFunc 
是 一 个 函数 对 象 ， 它 通常 作为 回调 函数 用 于 该 实例 的 初始 化 。 这 三 个 参数 之 后 ， 我 
们 可 以 再 增加 任意 数量 的 其 它 可 选 参 数 。 


这 个 函数 的 第 一 行 ，pre = preClass()， 内 省 地 实例 化 这 个 预 创 建 对 象 ， 使 用 作为 参 
数 传 递 过 来 的 类 对 象 。 下 面 一 行 根据 参数 prelnitFunc 内 省 地 调用 回调 函数 ， 它 通常 
设置 扩展 样式 标记 。 然 后 pre.Create() 方 法 被 调用 ， 它 使 用 了 可 选 的 参数 。 最 

后 ，PostCreate 方 法 被 调用 来 将 内 在 的 值 从 pre 移 给 实例 。 至 此 ，instance 参 数 已 经 
完全 被 创建 了 。 假 设 twoStepCreate 已 被 导入 ， 那 么 上 面 的 公用 兄 数 可 以 如 例 8.5 被 
使 用 。 


例 8.5 另 一 个 两 步 式 的 创建 ， 使 用 了 公用 函数 





import wx 
class HelpFrame(wx.Frame): 


def | init (self, parent, ID, title, pos=wx.DefaultPosition, siz 
e=(100, 100), style-wx.DEFAULT. DIALOG STYLE): 
twoStepCreate(self, wx.PreFrame, self.preInit, parent, 
id, title, pos, size, style) 


def preInit(self, pre): 
pre.SetExtraStyle(wx.FRAME EX CONTEXTHELP) 


类 wx.PreFrame 和 函数 self.prelnit 被 传递 给 公用 函数 ， 并 且 prelnit 方 法 被 定义 为 回调 


当 关 闭 一 个 框架 时 都 发 生 了 什么 ? 


当 你 关闭 一 个 框架 时 ， 它 最 终 消失 了 。 除 非 这 个 框架 被 明确 地 告诉 不 关闭 。 换 句 话 
说 ， 那 关闭 不 是 直接 了 当 的 。 在 wxPython 的 窗口 部 件 关闭 体系 之 后 的 用 意 是 ， 给 正 
在 关闭 的 窗口 部 件 充足 的 机 会 来 关闭 或 释放 它 所 占用 任何 非 WxPython 资 源 。 如 果 你 
占用 了 某 种 部 贵 的 外 部 资源 ， 如 一 个 大 的 数据 结构 或 一 个 数据 库 连 接 ， 那 么 该 意图 
是 特别 受 欢迎 的 。 


诚然 ， 在 C++ WXWidgets 世 界 里 ， 由 于 C++ 不 为 你 管理 内 在 分 配 的 清理 工作 ， 管 理 
资源 是 更 严肃 的 问题 。 在 wxPython 中 ， 对 于 多 步 的 关闭 过 程 的 显 式 需求 就 很 少 ， 但 
它 对 于 在 过 程 中 使 用 额外 的 钧 子 仍然 是 有 用 的 。 (随便 说 一 下 ， 我 们 在 这 一 节 中 从 


单词 "框架 "切换 到 单词 “窗口 部 件 "是 故意 的 
有 顶级 窗口 部 件 ， 如 框架 或 对 话 框 ) 。 


何 时 用 户 触发 关闭 过 程 


关闭 过 程 最 常 由 用 户 触发 ， 如 敲 击 一 个 关闭 框 或 选择 系统 菜单 中 的 关闭 项 或 当 应 用 
程序 响应 其 它 某 个 事件 而 调用 框架 的 Close 方 法 。 当 上 述 情况 发 生 时 ，wxPython 架 
构 引 发 一 个 EVT_CLOSE 事 件 。 像 wxPython 架构 中 的 其 它 别 的 事件 一 样 ， 你 可 以 
在 绑 定 一 个 事件 处 理 器 以 便 一 个 EVT_CLOSE 事 件 发 生 时 调用 。 


如 果 你 不 声明 你 自己 的 事件 处 理 器 ， 那 么 默认 的 行为 将 被 调用 。 默 认 的 行为 对 于 杠 
架 和 对 话 框 是 不 同 的 。 


1、 默 认 情 况 下 ， 框 架 处 理 器 调用 Destroy() 方 法 并 删除 该 框架 和 它 的 所 有 的 组 件 。 


2、 默 认 情 况 下 ， 对 话 框 的 关闭 处 理 器 不 销毁 该 对 话 框 它 仅 仅 模 拟 取 消 按钮 的 
按 下 ， 并 隐藏 对 话 框 。 该 对 话 框 对 象 仍 继续 存在 在 内 存 中 。 因 此 ， 如 果 需 要 的 话 ， 
应 用 程序 可 以 从 它 的 数据 输入 部 件 获 取 值 。 当 应 用 程序 完成 了 对 对 话 框 的 使 用 后 ， 
应 该 调用 对 话 框 的 Destroy() 方 法 。 


如 果 你 编写 你 自己 的 关闭 处 理 器 ， 那 么 你 可 以 使 用 它 来 关闭 或 删除 任何 外 部 的 资 
源 ， 但 是 ， 如 果 你 选择 去 删除 框架 的 话 ， 显 式 地 调用 Destroy() 方 法 是 你 的 责任 。 尽 
管 Destroy() 经 常 被 Close() 调 用 ， 但 是 只 调用 Close() 方 法 不 能 保证 框架 的 销 贷 。 在 
一 定 的 情形 下 ， 决 定 不 销毁 框架 是 完全 可 以 的 ， 如 当 用 户 取 消 了 关闭 。 然 而 ， 你 仍 
然 需要 一 个 方法 来 销毁 该 框架 。 如 果 你 选择 不 去 销毁 窗口 ， 那 么 调用 关闭 事件 的 
WX.CloseEvent.Veto() 方 法 来 通知 相关 部 分 : 框架 拒绝 关闭 ， 是 一 个 好 的 习惯 。 


如 果 你 选择 在 你 的 程序 的 别处 而 非 关闭 处 理 器 中 关闭 你 的 框架 ， 例 如 从 一 个 不 同 的 
用 户 事件 像 一 个 菜单 项 ， 那 么 我 们 建议 使 用 的 机 制 是 调用 框架 的 Close() 方 法 。 这 将 
启动 一 个 和 系统 关闭 行为 相同 的 过 程 。 如 果 你 要 确保 框架 一 定 被 删除 ， 那 么 你 可 以 
直接 调用 Destroy() 方 法 ; 然而 ， 如 果 你 这 样 做 了 ， 可 能 会 导致 框架 所 管理 的 资源 或 
数据 没有 被 释放 或 保存 。 


什么 时 候 系 统 触发 关闭 过 程 


如 果 关 闭 事 件 是 由 系统 自己 触发 的 ， 对 于 系统 关闭 或 类 似 情况 ， 你 也 有 一 种 办 法 管 
理 该 事件 。wxX.App 类 接受 一 个 EVT_QUERY_END_SESSION 事 件 ， 如果 需 要 的 

话 ， 该 事件 使 你 能 够 否决 应 用 程序 的 关闭 ， 如 果 所 有 运行 的 应 用 已 经 批准 了 系统 或 
GUI 环 境 的 关闭 的 话 ， 那 么 随后 会 有 一 个 EVT_END_SESSION 事 件 。 你 选择 去 否决 
关闭 的 行为 是 与 依赖 于 具体 系统 的 。 


最 后 ， 值 得 注意 的 是 ， 调 用 一 个 窗口 部 件 的 Destroy() 方 法 不 意味 该 部 件 被 立即 销 
毁 。 销 毁 实际 上 是 当 事 件 循 环 在 未 来 空闲 时 《任何 未 被 处 理 的 事件 被 处 理 之 后 ) 才 
被 处 理 的 。 这 就 防止 了 处 理 已 不 存在 的 窗口 部 件 的 事件 。 


在 接 下 来 的 两 节 ， 我 们 的 讨论 将 从 一 个 框架 的 生命 周期 切换 到 在 框架 生命 周期 里 ， 
你 能 够 用 框架 来 做 些 什么 。 


因为 在 本 节 中 的 所 有 内 容 都 适用 于 所 








使 用 框架 


框架 包含 了 许多 方法 和 属性 。 其 中 最 重要 的 是 那些 查找 框架 中 任意 窗口 部 件 的 方 
法 ， 和 滚动 框架 中 内 容 的 方法 。 在 这 一 节 ， 我 们 将 讨论 如 何 实现 这 些 。 


wxXx.Frame 有 那些 方法 和 属性 ? 


这 部 分 中 的 表 和 包含 了 Wx.Frame 和 它 的 父 类 Wx.Window 的 最 基本 的 属性 。 这 些 属性 
和 方法 的 许多 在 本 书 中 的 其 它 地 方 有 更 详细 的 说 明 。 表 8.4 包 含 了 Wx.Frame 的 一 些 


公共 的 可 读 、 可 修改 的 属性 。 
表 8.4 wx.Frame 的 公共 属性 


GetBackgroundColor(),SetBackgroundColor(wx.Color) 


Getld(),Setld(int) 


GetMenuBar(),SetMenuBar(wx.MenuBar) 


GetPosition(), GetPositionTuple(), SetPosition(wx.Point) 


背景 色 是 框架 中 没有 
PREF BO aR AR ce 
住 的 那些 部 分 的 闫 
色 。 你 可 以 传递 一 个 
wx.Color 3i Jfi &, 25 
设置 方法 。 任 何 传递 
给 需要 颜色 的 
wxPython 方 法 的 字 
符 串 ， 都 被 解释 为 对 
wx.NamedColour() 
的 调用 。 


返回 或 设置 窗口 部 件 
的 标识 符 。 


得 到 或 设置 框架 当前 
使 用 的 的 菜单 栏 对 
Ro tRAA KS 
栏 ， 则 返回 None。 


以 一 个 wx.Point 或 
Python 元 组 的 形式 返 
回 窗口 左上 角 的 x,y 
的 位 置 。 对 于 顶级 窗 
口 ， 该 位 置 是 相对 于 
显示 区 域 的 坐标 ， 对 
于 子 窗 口 ， 该 位 置 是 
相对 于 父 窗 口 的 坐 


标 。 


GetSize() GetSizeTuple() SetSize(wx.Size) : C++ 版 的 get 或 Set 方法 被 徐 盖 。 默 认 
的 get 或 set 使 用 一 个 Wwx.Size 对 象 。GetSizeTuple() 方 法 以 一 个 Python 元 组 的 形式 返 
回 尺寸 。 也 可 以 参看 访问 该 信息 的 另外 的 方法 SetDimensions()。 


GetTitle() SetTitle(String) : 得 到 或 设置 框架 标题 栏 的 字符 串 。 


表 8.5 显 示 了 一 些 wx.Frame 的 非 属性 类 的 更 有 用 的 方法 。 其 中 要 牢记 的 是 
Refresh()， 你 可 以 用 它 来 手动 触发 框架 的 重 绘 。 


表 8.5 WX.Frame 的 方法 


Center(direction=wx.BOTH) : 框架 居中 (注意 ， 非 美语 的 拼写 Centre， 也 被 定义 了 
的 ) 。 参 数 的 默认 值 是 wx.BoTH， 在 此 情况 下 ， 框 是 在 两 个 方向 都 居中 的 。 参 数 的 
值 若 是 wx.HORIZONTAL 或 wx.VERTICAL， 表 示 在 水 平 或 重 直 方向 居中 。 


Enable(enable=true) : 如 果 参 数 为 true， 则 框架 能 够 接受 用 户 的 输入 。 如 果 参 数 为 
False， 则 用 户 不 能 在 框架 中 输入 。 相 对 应 的 方法 是 Disable()。 


GetBestSize() : 对 于 wx.Frame， 它 返回 框架 能 容纳 所 有 子 窗口 的 最 小 尺寸 。 


Iconize(iconize) : 如 果 参 数 为 true， 最 小 化 该 框架 为 一 个 图 标 〈 当 然 ， 有 具体 的 行为 
与 系统 有 关 ) 。 如 果 参 数 为 False， 图 标 化 的 框架 恢复 到 正常 状态 。 


IsEnabled() : 如 果 框 架 当 前 有 效 ， 则 返回 True 。 


IsFullScreen() : 如 果 框 架 是 以 全 屏 模 式 显 示 的 ， 则 返回 True， 和 否则 False。 细 节 参 
看 ShowFullScreen。 


Islconized() : 如 果 框 架 当 前 最 小 化 为 图 标 了 ， 则 返回 True， 和 否则 False。 
IsMaximized() : 如 果 框 架 当 前 是 最 大 化 状态 ， 则 返回 True， 否 则 False 。 
IsShown() : 如 果 框 架 当 前 可 见 ， 则 返回 True。 


IsTopLevel() : 对 于 顶级 窗口 部 件 如 框架 或 对 话 框 ， 总 是 返回 True， 对 于 其 它 类 型 
的 窗口 部 件 返回 False。 


Maximize(maximize) : 如 果 参 数 为 True， 最 大 化 框架 以 填充 屏幕 (具体 的 行为 与 系 
RAK) 。 这 与 需 击 框架 的 最 大 化 按钮 所 做 的 相同 ， 这 通常 放大 框架 以 卉 充 桌 面 ， 
但 是 任务 栏 和 其 它 系 统 组 件 仍 然 可 见 。 


Refresh(eraseBackground=True, rect=None) : 触发 该 框架 的 重 绘 事件 。 如 果 rect 
是 none， 那 么 整个 框架 被 重 画 。 如 果 指 定 了 一 个 矩形 区 域 ， 那 么 仅 那个 矩形 区 域 被 
重 画 。 如 果 eraseBackground 为 True， 那 么 这 个 窗口 的 北 影 也 将 被 重 画 ， 如 果 为 
False， 那 么 背景 将 不 被 重 画 。 


SetDimensions(x, y, width, height, sizeFlags=wx.SIZE_AUTO) : 使 你 能 够 在 一 个 
方法 调用 中 设置 窗口 的 尺寸 和 位 置 。 位 置 由 参数 X 和 y 决 定 ， 尺 寸 由 参数 width 和 
height 决 定 。 前 四 个 参数 中 ， 如 果 有 的 为 -1， 那 么 这 个 -1 将 根据 参数 sizeFlags 的 值 
作 相 应 的 解释 。 表 8.6 包 含 了 参数 sizeFlags 的 可 能 取 值 。 


Show(show=True) : 如 果 参 数值 为 True， 导 致 框架 被 显示 。 如 果 参 数值 为 False * 
导致 框架 被 隐藏 。Show(False) 等 同 于 Hide() 。 


ShowFullScreen(show, style=wx.FULLSCREEN_ALL) : 如 果 布 尔 参 数 是 True， 那 
么 框架 以 全 屏 的 模式 被 显示 意味 着 框架 被 放大 到 填充 整个 显示 区 域 ， 包 括 桌 面 
上 的 任务 栏 和 其 它 系统 组 件 。 如 果 参 数 是 False， 那 么 框架 恢复 到 正常 尺寸 。style 

参数 是 一 个 位 掩 码 。 默 认 值 Wx.FULLSCREEN_ALL 指 示 wxPython 当 全 屏 模 式 时 隐 
藏 所 有 窗口 的 所 有 样式 元 素 。 后 面 的 这 些 值 可 以 通过 使 用 按 位 运算 符 来 组 合 ， 以 取 





消 全 屏 模 式 框架 的 部 分 装饰 : wxFULLSCREEN NOBORDER, 
wx.FULLSCREEN_NOCAPTION, wx.FULLSCREEN NOMENUBAR, 
wx.FULLSCREEN NOSTATUSBAR, wx.FULLSCREEN NOTOOLBAR ° 


表 8.5 中 说 明 的 SetDimensions() 方 法 在 用 户 将 一 个 尺寸 指定 为 -1 时 ， 使 用 尺寸 标记 
的 一 个 位 掩 码 来 决定 默认 行为 。 表 8.6 说 明了 这 些 标 记 。 


这 些 方法 没有 涉及 框架 所 包含 的 孩子 的 位 置 问题 。 这 个 问题 要 求 框架 的 孩子 自己 去 
说 明 它 。 


表 8.6 关于 SetDimensions 方 法 的 尺寸 标记 

wx.ALLOW_MINUS_ONE : 一 个 有 效 的 位 置 或 尺寸 。 

wx.SIZE_AUTO : 转换 为 一 个 wxPython 上 默认 值 。 
wx.SIZE_AUTO_HEIGHT : 一 个 有 效 的 高 度 ， 或 一 个 wxPython 默 认 高 度 。 
wx.SIZE AUTO WIDTH : 一 个 有 效 的 宽度 ， 或 一 个 wxPython 上 默认 宽度 。 
wx.SIZE USE EXISTING : 使 用 现 有 的 尺寸 。 


如 何 查找 框架 的 子 禄 口 部 件 ? 


有 时 候 ， 你 将 需要 查找 框架 或 面板 (panel) 上 的 一 个 特定 的 窗 wat 并 且 你 没有 它 
的 相关 引用 。 如 第 6 章 所 示 的 这 种 情况 的 一 个 公用 的 应 用 程序 ， 它 查找 与 所 选 菜 
相关 的 实际 的 菜单 项 对 象 (因为 事件 不 包含 对 它 的 一 个 引用 ) 。 另 一 种 情况 就 是 ， 
当 你 想 基于 一 个 项 的 事件 去 改变 系统 中 其 它 任 一 窗口 部 件 的 状态 时 。 例 如 ， e 
有 一 个 按钮 和 一 个 菜单 项 ， 它 们 互相 改变 彼此 的 开关 状态 。 当 按钮 被 敲 击 时 ， 你 需 

要 去 得 到 菜单 项 以 触发 它 。 例 8.6 显 示 了 一 个 摘自 第 7 章 的 一 个 小 的 例子 。 在 这 之 个 代 
码 中 ，FindltemByld() 方 法 用 来 去 获得 与 事件 对 象 所 提供 的 ID 相关 的 菜单 项 。 该 项 
的 标签 被 用 来 驱动 所 要 求 的 颜色 的 改变 。 


例 8.6 通过 ID 查找 项 目的 函数 


def OnColor(self, event): 
menubar = self.GetMenuBar() 
itemId = event.GetId() 
item = menubar .FindItemById(itemId) 
color = item.GetLabel() 
self.sketch.SetColor(color ) 


在 WxPython 中 ， 有 三 种 查找 子 窗口 部 件 的 方法 ， 它 们 的 行为 都 很 相似 。 这 些 方法 对 
任何 作为 容器 的 窗口 部 件 都 是 适用 的 ， 不 单单 是 框架 " 还 有 对 话 框 和 面板 (panel) 。 
你 oe a ID 得 寻 一 个 窗口 部 件 ， 或 通过 传递 给 构造 函数 的 名 字 

(在 name 参 数 中 ) ， 或 通过 文本 标签 来 查寻 。 文 本 标签 被 定义 为 相应 窗口 部 件 的 
标题 ， 如 按钮 和 框架 


这 三 种 方法 是 : 


e 1.wx.FindWindowByld(id, parent=None) 
1.wx.FindWindowByName(name, parent=None) 
1.wx.FindWindowByLabel(label, parent=None) 
这 三 种 情况 中 ，parent 参 数 可 以 被 用 来 限制 为 对 一 个 特殊 子 层次 的 搜索 (也 就 是 ， 
它 等 同 于 父 类 的 Find 方 法 ) 。 还 有 ，FindWindowByName() 首 先 按 name 参 数 查 
找 ， 如 果 没 有 发 现 匹 配 的 ， 它 就 调用 FindWindowByLabel() 去 查找 一 个 匹配 。 
如 何 创建 一 个 带 有 滚动 条 的 框架 ? 


在 wxPython 中 ， 滚 动 条 不 是 框架 本 身 的 一 个 元 素 ， 而 是 被 类 Wx.ScrolledWindow 控 
制 。 你 可 以 在 任何 你 要 使 用 wx.Panel 的 地 方 使 用 wx.ScrolledWindow， 并 且 滚 动 条 
移动 所 有 在 滚动 窗口 中 的 项 目 。 图 8.5 和 图 8.6 显 示 了 滚动 条 ， 包 括 它 的 初始 状态 和 
滚动 后 的 状态 。 从 图 8.5 到 图 8.6， 左 上 的 按钮 移出 了 视野 ， 右 下 的 按钮 移 进 了 视 
野 。 


在 这 一 节 ， 我 们 将 讨论 如 何 去 创 建 一 个 带 有 滚动 条 的 窗口 以 及 如 何在 你 的 程序 中 处 
PRG ° 
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Figure8.5 Awx.Scrolled-Window 
after initial creation 


图 8.6 
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Figure8.5 Awx.Scrolled-Window 
after initial creation 


如 何 创 建 滚动 条 
例 8.7 显 示 了 用 于 创建 滚动 窗口 的 代码 。 
例 8.7 创建 一 个 简单 的 滚动 窗口 


import wx 


class ScrollbarFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, -1, 'Scrollbar Example', 
size-(300, 200)) 

self.scroll - wx.ScrolledWindow(self, -1) 

self.scroll.SetScrollbars(1, 1, 600, 400) 

self.button - wx.Button(self.scroll, -1, "Scroll Me", po 
s-(50, 20)) 

self.Bind(wx.EVT BUTTON, self.OnClickTop, self.button) 

self.button2 - wx.Button(self.scroll, -1, "Scroll Back", 
pos-(500, 350)) 

self.Bind(wx.EVT BUTTON, self.OnClickBottom, self.button 
2) 


def OnClickTop(self, event): 
self.scroll.Scroll(600, 400) 


def OnClickBottom(self, event): 
self .scroll-Scroll(i, 1) 


if _name__ == ' main ': 
app = wx.PySimpleApp( ) 
frame = ScrollbarFrame() 
frame. Show( ) 
app .MainLoop( ) 


wx. ScrolledWindow 8 44 3& & žk JU3- 4 wx.Panela 44 FJ] : 


wx.ScrolledWindow(parent, id=-1, pos=wx.DefaultPosition, 
size=wx.DefaultSize, style=wx.HSCROLL | wx.VSCROLL, 
name-"scrolledwindow") 


所 有 的 这 些 属 性 的 行为 都 如 你 所 愿 ， 尽 管 size 属 性 是 它 的 父亲 中 的 面板 的 物理 尺 
寸 ， 而 非 滚动 窗口 的 逻辑 尺寸 。 
指定 滚动 区 域 的 尺 二 


有 人 几 个 自动 指定 滚动 区 域 尺 寸 的 方法 。 手 工 指定 最 多 的 方法 如 例 8.1 所 示 ， 使 用 了 方 
法 SetScrollBars : 


SetScrollbars(pixelsPerUnitX, pixelsPerUnitY, noUnitsX, noUnitsY 


, 


xPos=0, yPos=0, noRefresh-False) 


Ev 关键 的 概念 是 滚动 单位 ， 它 是 滚动 条 的 一 次 移动 所 引起 的 窗口 中 的 转移 距离 。 
前 面 的 两 个 参数 pixelsPerUnitX 和 PixelsPerUnitY 使 你 能 够 在 两 个 方向 设置 滚动 单位 
的 大 小 。 接 下 来 的 两 个 参数 noUnitsX 和 noUnitsY 使 你 能 够 按 滚动 单位 设置 滚动 区 域 
的 尺寸 。 换 句 话 说 ， 滚 动 区 域 的 象 素 尺寸 是 (pixelsPerUnitX noUnitsX, 
pixelsPerUnitY noUnitsY)。 例 8.7 通 过 将 滚动 单位 设 为 1 像素 而 避免 了 可 能 造成 的 混 
消 。 参 数 XPos 和 yPos 以 滚动 单位 〈 非 像素 ) 为 单位 ， 它 设置 滚动 条 的 初始 位 置 ， 
如 果 参 数 noRefresh 为 true， 那 么 就 阻止 了 在 因 SetScrollbars() 的 调用 而 引起 的 滚动 
后 的 窗口 的 自动 刷新 。 


能 发 现 这 些 方法 更 容易 使 用 ， 因 为 它们 使 你 能 够 更 直接 地 指定 尺寸 。 你 可 以 如 下 
ees 单位 使 用 滚动 窗口 的 SetVirtualSize() 方 法 来 直接 设置 尺寸 。 


self.scroll.SetVirtualSize((600, 400) ) 


使 用 方法 FitInside() ， 你 可 以 在 滚动 区 域 中 设置 窗口 部 件 ， 以 便 滚动 窗口 绑 定 它 
们 。 这 个 方法 设 er 口 的 边界 ， 以 使 滚动 窗口 刚好 适合 其 中 的 所 有 子 窗口 : 


self.scroll.FitInside() 


通常 使 用 Fitlnside() 的 情况 是 ， 当 在 滚动 窗口 中 正好 有 一 个 窗口 部 件 (如 文本 
R) ， 并 且 该 窗口 部 件 的 逻辑 尺寸 已 被 设置 。 如 果 我 们 在 例 8.7 中 使 用 了 
FitInside()， 那 么 一 个 更 小 的 滚动 区 域 将 被 创建 ， 因 为 该 区 域 将 正好 匹配 右 下 按钮 
的 边缘 ， 而 没有 多 余 的 内 边 距 。 


最 后 ， 如 果 滚 动 窗口 中 有 一 个 sizer 设 置 ， > 那么 使 用 SetSizer() 设 置 滚 动 区 域 为 sizer 
所 管理 的 窗口 部 件 的 尺寸 。 这 是 在 一 个 复杂 的 布局 中 最 常用 的 机 制 。 关 于 sizer 的 更 
多 细节 参见 第 11 章 。 


对 于 上 述 所 有 三 种 机 制 ， 滚 动 率 需 要 去 使 用 SetScrollRate() 方 法 单独 设置 ， 如 下 所 
示 


self.scroll.SetScrollRate(1, 1) 


参数 分 别 是 x 和 y 方 向 的 滚动 单位 尺寸 。 大 于 0 的 尺寸 都 是 有 效 的 。 
滚动 条 事件 


在 例 8.7 中 的 按钮 事件 处 理 器 ， 使 用 Scroll() 方 法 程序 化 地 改变 滚动 条 的 位 置 。 这 个 
方法 需要 滚动 窗口 的 xX 和 y 坐 标 ， 使 用 的 是 滚动 单位 。 

在 第 7 章 中 ， 我 们 答应 了 你 可 以 捕获 的 来 自 滚动 条 的 事件 列表 ， 因 为 它们 也 被 用 来 
去 控制 滑 块 。 表 8.7 列 出 了 所 有 被 滚动 窗口 内 在 处 理 的 滚动 事件 。 通 常 ， 许 多 你 不 会 
用 到 ， 除 非 你 建造 自 定 义 窗口 部 件 。 


表 8.7 滚动 条 的 事件 


EVT_SCROLL 当 任 何 滚动 事件 被 触发 时 发 生 。 


当 用 户 移动 滚动 条 到 它 的 范围 的 最 末端 时 
触发 〈 底 边 或 右边 ， 依 赖 于 方向 ) 。 


在 微软 的 Windows 中 ， 任 何 滚 动 会 话 的 结 


EVT_SCROLL_BOTTOM 


EVT_SCROLL_ENDSCROLL 束 都 将 触发 该 事件 ， 不 管 是 因 鼠 标 拖 动 或 
按键 按 下 。 

EVT_SCROLL LINEDOWN 当 用 户 向 下 滚动 一 行 时 触发 。 

EVT_SCROLL_LINEUP 当 用 户 向 上 滚动 一 行 时 触发 。 

EVT_SCROLL_PAGEDOWN 当 用 户 向 下 滚动 一 页 时 触发 。 

EVT_SCROLL_PAGEUP 当 用 户 向 上 滚动 一 页 时 触发 。 


用 户 使 用 鼠标 拖 动 滚动 条 滚动 不 超过 一 页 


EVT_SCROLL_THUMBRELEASE HLA’ HRRAEG > 触发 该 事件 。 


EVT_SCROLL THUMBTRACK 滚动 条 在 一 页 内 被 拖 动 时 不 断 的 触发 。 
当 用 户 移动 滚动 条 到 它 的 范围 的 最 始 端 时 
EVT_SCROLL TOP 触发 ， 可 能 是 顶端 或 左边 ， 依 赖 于 方向 而 
Ge o 
行 和 页 的 准确 定义 依赖 于 你 所 设 定 的 滚动 单位 ， 一 行 是 一 个 滚动 单位 ， 一 页 是 滚动 


窗口 中 可 见 部 分 的 全 全 部 滚动 单位 的 数量 。 对 于 表 中 所 列 出 的 每 个 EVT_SCROLL 事 
件 ， 都 有 一 个 相应 的 EVT_SCROLLWIN 事 件 (它们 由 wx.ScrolledWindow 产 生 ) 来 
回应 。 


还 有 一 Ro 的 特殊 的 滚动 窗口 子 类 : wx.lib.scrolledpanel.ScrolledPanel * 
它 使 得 你 能 够 在 面板 上 自动 地 设置 滚动 ， 该 面板 使 用 一 个 sizer 来 管理 子 窗 窗口 部 件 的 
布局 。wx.lib.scrolledpanel.ScrolledPanel 增 加 的 好 处 是 ， 它 让 用 户 能 够 使 用 tab 键 
来 在 子 窗口 部 件 问 切换 。 面 板 自动 滚动 ， 使 新 获得 焦点 的 窗口 部 件 进 入 视野 。 要 使 
用 WwWx.lib.scrolledpanel.ScrolledPanel， 就 要 像 一 个 滚动 窗口 一 样 声明 它 ， 然 后 ， 在 
所 有 的 子 窗 口 被 添加 后 ， 调 用 下 面 的 方法 : 


SetupScrolling(self, scroll_x=True, scroll_y=True, rate_x=20, 
rate_y=20) 


rate_x 和 rate_y 是 窗口 的 滚动 单位 ， 该 类 自动 根据 sizer 所 计算 的 子 窗口 部 件 的 尺寸 
设 定康 拟 尺寸 (virtual size)。 记 住 ， 当 确定 滚动 窗口 中 的 窗口 部 件 的 位 置 的 时 候 ， 
该 位 置 总 是 窗口 部 件 的 物理 位 置 ， 它 相对 于 显示 器 中 的 滚动 窗口 的 实际 原点 ， 而 非 
窗口 部 件 相 对 于 显示 器 虚拟 尺寸 (virtual size) 的 逻辑 位 置 。 这 始终 是 成 立 的 ， 即 使 窗 
口 部 件 不 再 可 见 。 例 如 ， 在 敲 击 了 图 8.5 中 的 Scroll Me 按钮 后 ， 该 按钮 所 报告 的 它 

的 位 置 是 (-277,-237)。 如 果 这 不 的 你 所 想 要 的 ， 那 么 使 用 CalcScrolledPosition(x,y) 
和 。CalcUnscrolledPosition(x, y) 方 法 在 显示 器 坐标 和 逻辑 坐标 之 间 切 换 。 在 这 两 
种 情况 中 ， 在 按钮 敲 击 并 使 滚动 条 移动 到 底部 后 ， 你 传递 指针 的 坐标 ， 并 且 深 动 窗 
口 返回 一 个 (Xx,y) 元 组 ， 如 下 所 示 : 


CalcUnscrolledPostion(-277, -237) # 


可 选 的 框架 类 型 


框架 不 限于 其 中 带 有 窗口 部 件 的 普通 的 矩形 ， 它 可 以 呈现 其 它 的 形状 。 你 也 可 以 创 
MDI (多 文档 界面 ) 框架 ， 它 其 中 包含 别 的 框架 。 或 者 你 也 可 以 去 掉 框 架 的 标题 
栏 ， 并 且 仍 然 可 以 使 用 户 能 拖 动 框架 。 


如 何 创 建 一 个 MDI 框 架 ? 


还 记得 MDI 吗 ?许多 人 都 不 记得 了 。MDI 是 微软 90 年 代 初 的 创新 ， 它 使 得 一 个 应 用 
程序 中 的 多 个 子 窗口 能 被 一 个 单一 的 父 窗口 控制 ， 本 质 上 为 每 个 应 用 程序 提供 了 一 
个 独立 的 桌面 。 在 大 多 数 应 用 程序 中 ，MDI 要 求 应 用 程序 中 的 所 有 窗口 同时 最 小 
化 ， 并 保持 相同 的 z 轴 次 序 (相对 系统 中 的 其 它 部 分 ) 。 我 们 建议 仅 当 用 户 期 望 同 
时 看 到 所 有 的 应 用 程序 窗口 的 情况 下 使 用 MDI， 例 如 一 个 游戏 。 图 8.7 显 示 了 一 个 典 
型 的 MDI 环 境 。 


在 wxPython 中 MDI 是 被 支持 的 ， 在 Windows 操 作 系 统 下 通过 使 用 本 地 窗口 部 件 来 实 
现 MDI， 在 其 它 的 操作 系统 中 通过 模拟 子 窗口 实现 MDI。 例 8.8 提 供 了 一 简单 的 MDI 
的 例子 。 





图 8.7 
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Figure 8.7 
An MDI window 




















18.8 如 何 创建 一 个 MDI 窗 口 


import wx 


class MDIFrame(wx.MDIParentFrame) : 


def 


__ init__(self): 


wx.MDIParentFrame.__init__(self, None, -1, "MDI Parent", 


def 


def 


if name == ' main ': 


app 


size=(600, 400) ) 
menu = wx.Menu() 
menu.Append(5000, " Window") 
menu.Append(5001, "E ") 
menubar = wx.MenuBar() 
menubar .Append (menu, " ") 
self .SetMenuBar (menubar) 
self.Bind(wx.EVT MENU, self.OnNewWindow, id=5000) 
self.Bind(wx.EVT MENU, self.OnExit, id=5001) 


OnExit(self, evt): 
self.Close(True) 


OnNewWindow(self, evt): 
win - wx.MDIChildFrame(self, -1, "Child Window") 
win.Show(True) 


- wx.PySimpleApp() 


frame - MDIFrame() 
frame.Show() 


app. 


MainLoop() 


MDI 的 基本 概念 是 十 分 简单 的 。 父 窗口 是 wx.MDIParentFrame 的 一 个 子 类 ， 子 窗口 


如 同 任何 其 


它 的 WxPython 窗 口 部 件 一 样 被 添加 ， 除 了 它们 是 wx.MDIChildFrame 的 


子 类 。wx.MDIParentFrame 的 构造 函数 与 wx.Frame 的 基本 相同 ， 如 下 所 示 : 


wx.MDIParentFrame(parent, id, title, pos = wx.DefaultPosition, 
size=wxDefaultSize, 
style=wx.DEFAULT_FRAME_STYLE | wx.VSCROLL | wx.HSCROLL, 


name="frame" ) 


不 同 的 一 点 是 wx.MDIParentFrame 在 默认 情况 下 有 滚动 条 。wx.MDIChildFrame 的 


构造 函数 是 相同 的 ， 除 了 它 没有 滚动 条 。 如 例 8.8 所 示 ， 添 加 一 个 子 框 架 是 通过 创建 


一 个 以 父 框架 为 父亲 的 框架 来 实现 的 。 


你 可 以 通过 使 用 父 框架 的 Cascade() 或 Tile() 方 法 来 同时 改变 所 有 子 框架 的 位 置 和 尺 
寸 ， 它 们 模拟 相同 名 字 的 菜单 项 。 调 用 Cascade()， 导 致 一 个 窗口 显示 在 其 它 的 上 
面 ， 如 图 8.7 的 所 示 ， 而 Tile() 使 每 个 窗口 有 相同 的 尺寸 并 移动 它们 以 使 它们 不 重 
登 。 要 以 编程 的 方式 在 子 窗口 中 移动 焦点 ， 要 使 用 父亲 的 方法 ActivateNext() 和 


ActivatePrevious() 


什么 是 小 型 框架 ， 我 们 为 何 要 用 它 ? 


小 型 框架 是 一 个 有 两 个 例外 的 矩形 框架 : 它 有 一 个 较 小 的 标题 区 域 ， 并 且 在 微软 的 
Windows 下 或 GTK 下 ， 它 不 在 任务 栏 中 显示 。 图 8.8 显 示 了 一 个 较 小 标题 域 的 一 个 
例子 。 


图 8.8 一 个 小 型 框架 


























Figure 8.8 A mini-frame in action 


创建 小 型 框架 的 代码 基本 上 等 同 于 创建 一 个 矩形 框架 ， 唯 一 的 不 同 是 父 类 是 
wx.MiniFrame 。 例 8.9 显 示 了 这 个 代码 o 


例 8.9 创建 一 个 小 型 框架 


import wx 


class MiniFrame(wx.MiniFrame) : 
def _ init (self): 
wx.MiniFrame.__init__(self, None, -1, 'Mini Frame', 
size-(300, 100)) 

panel = wx.Panel(self, -1, size=(300, 100)) 
button - wx.Button(panel, -1, "Close Me", pos-(15, 15)) 
self.Bind(wx.EVT BUTTON, self.OnCloseMe, button) 
self.Bind(wx.EVT CLOSE, self.OnCloseWindow) 


def OnCloseMe(self, event): 
self.Close(True) 


def OnCloseWindow(self, event): 
self.Destroy() 
if name == ' main ': 
app - wx.PySimpleApp() 
MiniFrame().Show() 
app.MainLoop() 


wx.MiniFrame 8 44 3& 3 Zt + Is] T wx.Frame tg > em > wx.MiniFrame X 4S 3f 7p 85 4% 
式 标记 。 如 表 8.8 所 示 。 


表 8.8 WX.MiniFrame 的 样式 标记 


| ay j , FA i 绘 御 
wx.THICK FRAME ieee 使 用 粗 边框 TA 制 


> tk eee ae 
wx. TINY. CAPTION. HORIZONTAL b LO CLAN pue 


代 蔡 Wx.CAPTION 而 显示 一 个 较 小 的 重 
wx.TINY_CAPTION_VERTICAL 直 标 题 。 


典型 的 ， 小 型 框架 被 用 于 工具 框 窗口 中 ， 在 工具 框 窗口 中 始终 是 有 效 的 ， 它 们 不 影 
响 任 务 栏 。 较 小 的 标题 使 得 它们 更 有 效 的 利用 空间 ， 并 且 明 显 地 区 别 于 标准 的 框 


Ao 
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在 大 多 数 应 用 程序 中 ， 框 架 都 是 矩形 ， 因 为 矩形 有 一 个 不 错 的 规则 的 形状 ， 并 且 绘 
制 和 维护 相对 简单 。 可 是 ， 有 时 候 你 需要 打破 直线 的 制约 。 在 WxPython 中 ， 你 可 以 
给 框架 一 个 任 一 的 形状 。 如 果 一 个 备用 的 形状 被 定义 了 ， 那 么 框架 超出 该 形状 的 部 
分 不 将 被 绘制 ， 并 且 不 响应 鼠标 事件 ; 对 于 用 户 而 言 ， 它 们 不 是 框架 的 一 部 分 。 图 
8.9 显 示 了 一 个 非 矩 形 的 窗口 ， 显 示 的 背景 是 文本 编辑 器 中 的 代码 。 


事件 被 设置 来 以 便 双 击 时 开关 这 个 非 标准 形状 ， 和 鼠标 右键 单 击 时 关闭 这 个 窗口 。 这 
个 例子 使 用 了 来 自 wxPython demo 的 images 模 块 作为 vippi 的 图 像 的 资源 ， 
wxPython 的 吉祥 物 。 


图 8.9 


class #fhapedRrame (wx. Frame): 
(self): 
45 .  ínit (self, None, -1, "S 
style = wx.FRAME SHAPED | wx 
gi. FRAME NO TASKBAR) 
hape = False 
= images.getVippibitmap |) 








Figure 8.9 
A window shaped into a 
familiar non-rectangular shape 
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精细 点 ， 以 显示 如 何在 缺少 典型 的 窗口 界面 装饰 的 情况 下 管理 像 窗口 关闭 之 类 的 事 
情 o 


18.10 绘制 符合 形状 的 窗口 


import wx 
import images 


class ShapedFrame(wx.Frame): 
def _ init (self): 
wx.Frame.__init__(self, None, -1, "Shaped Window", 
style = wx.FRAME_SHAPED | wx.SIMPLE_BORDER | 
wx . FRAME_NO_TASKBAR) 
self.hasShape = False 


#1 获取 图 像 

self.bmp = images.getVippiBitmap() 

self .SetClientSize((self.bmp.GetWidth(), self.bmp.GetHei 
ght())) 


#2 绘制 图 像 
dc = wx.ClientDC(self) 
dc.DrawBitmap(self.bmp, 0,0, True) 


self.SetwindowShape() 

self.Bind(wx.EVT LEFT DCLICK, self.OnDoubleClick) 

self.Bind(wx.EVT RIGHT UP, self.OnExit) 

self.Bind(wx.EVT PAINT, self.OnPaint) 

self.Bind(wx.EVT WINDOW Create, self.SetWindowShape )#3 
绑 定 窗口 创建 事件 


def SetWindowShape(self, evt=None):#4 设置 形状 
r = wx.RegionFromBitmap(self.bmp) 
self.hasShape = self.SetShape(r) 


def OnDoubleClick(self, evt): 
if self.hasShape: 
self .SetShape(wx.Region())#5 重 置 形状 
self.hasShape = False 
else: 
self .SetwindowShape() 


def OnPaint(self, evt): 
dc = wx.PaintDC(self) 
dc.DrawBitmap(self.bmp, 0,0, True) 


def OnExit(self, evt): 
self.Close() 
if | name == ' main ': 
app - wx.PySimpleApp() 
ShapedFrame( ).Show() 
app.MainLoop() 


#1 在 从 images 模 块 得 到 图 像 后 ， 我 们 将 窗口 内 部 的 尺寸 设置 为 位 图 的 尺寸 。 你 也 
可 以 根据 一 个 标准 的 图 像 文件 来 创建 这 个 wxPython 位 图 ， 这 将 在 第 16 章 中 作 更 详 


细 的 讨论 。 


#2 这 里 ， 我 们 在 窗口 中 绘制 这 个 图 像 。 这 决 不 是 一 个 必然 的 选择 。 你 可 以 像 其 它 窗 
口 一 样 在 该 形状 窗口 中 放置 窗口 部 件 和 文本 (尽管 它们 必须 在 该 形状 的 区 域内 ) © 


#3 这 个 事件 在 大 多 数 平台 上 是 多 余 的 ， 它 强制 性 地 在 窗口 被 创建 后 调 

用 SetWindowShape()。 但 是 ，GTK 的 实现 要 求 在 该 形状 被 设置 以 前 ， 窗 口 的 本 地 
UI 对 象 被 创建 和 确定 ， 因 此 当 窗 口 创建 发 生 时 我 们 使 用 窗口 创建 事件 去 通知 并 在 它 
的 处 理 器 中 设置 形状 。 


#4 我 们 使 用 全 局 方法 wx.RegionFromBitmap 去 创建 设置 形状 所 需 的 wx.Region 对 
象 。 这 是 创建 不 规则 形状 的 最 容易 的 方法 。 你 也 可 以 根据 一 个 定义 多 边 形 的 点 的 列 
表 来 创建 一 个 wx.Region。 图像 的 透明 部 分 的 用 途 是 定义 区 域 的 边界 。 


#5 双击 事件 开关 窗口 的 形状 。 要 回 到 标准 的 矩形 ， 要 使 用 一 个 空 的 wx.Region 作 为 
参数 来 调用 SetShape()。 


除了 没有 标准 的 关闭 框 或 标题 栏 等 外 ， 不 规则 形状 框架 的 行为 像 一 个 普通 的 框架 一 
样 。 任 何 框架 都 可 以 改变 它 的 形状 ， 因 为 SetShape() 方 法 是 wx.Frame 类 的 一 部 
分 ， 它 可 以 被 任何 子 类 继承 。 在 wx.SplashScreen 中 ， 符 合 形 状 的 框架 是 特别 的 有 
用 e 


如 何 拖 动 一 个 没有 标题 栏 的 框架 ? 


前 一 个 例子 的 明显 结果 是 这 个 没有 标题 栏 的 框架 不 能 被 拖 动 的 ， 这 儿 没 有 拖 动 窗口 
的 标准 方法 。 要 解决 这 个 问题 ， 我 们 需要 去 添加 事件 处 理 器 来 在 当 拖 动 发 生 时 移动 
该 窗口 。 例 8.11 显 示 与 前 一 例子 相同 形状 的 窗口 ， 但 增加 了 对 于 处 理 筷 标 堪 键 敲 击 
和 鼠标 移动 的 一 些 事件 。 这 个 技术 可 以 适用 于 任何 其 它 的 框架 ， 甚 至 是 框架 内 你 想 
要 移动 的 窗口 (例如 绘画 程序 中 的 元 素 ) © 


例 8.11 使 用 户 能 够 从 框架 来 拖 动 框架 的 事件 


import wx 
import images 


class ShapedFrame(wx.Frame): 
def — init (self): 
wx.Frame. init (self, None, -1, "Shaped Window", 
style = wx.FRAME SHAPED | wx.SIMPLE BORDER ) 

self.hasShape - False 

self.delta = wx.Point(0,0) 

self.bmp = images.getVippiBitmap() 

self .SetClientSize((self.bmp.GetWidth(), self.bmp.GetHei 
ght())) 

dc = wx.ClientDC(self ) 

dc.DrawBitmap(self.bmp, 0,0, True) 

self.SetwindowShape() 

self.Bind(wx.EVT LEFT DCLICK, self.OnDoubleClick) 


#1 新 事件 
self.Bind(wx.EVT LEFT DOWN, self.OnLeftDown) 
self.Bind(wx.EVT LEFT UP, self.OnLeftUp) 
self.Bind(wx.EVT MOTION, self.OnMouseMove) 


self.Bind(wx.EVT RIGHT UP, self.OnExit) 
self.Bind(wx.EVT PAINT, self.OnPaint) 
self.Bind(wx.EVT WINDOW Create, self.SetWindowShape) 


def SetWindowShape(self, evt=None): 
r = wx.RegionFromBitmap(self.bmp) 
self.hasShape = self.SetShape(r) 


def OnDoubleClick(self, evt): 
if self.hasShape: 
self.SetShape(wx.Region()) 
self.hasShape - False 
else: 
self.SetwindowShape() 


def OnPaint(self, evt): 
dc = wx.PaintDC(self) 
dc.DrawBitmap(self.bmp, 0,0, True) 


def OnExit(self, evt): 
self.Close() 


def OnLeftDown(self, evt):#2 鼠标 按 下 
self .CaptureMouse( ) 
pos = self.ClientToScreen(evt.GetPosition()) 
oigin = self.GetPosition( ) 
self.delta = wx.Point(pos.x - oigin.x, pos.y - oigin.y) 


def OnMouseMove(self, evt):#3 鼠标 移动 
if evt.Dragging() and evt.LeftIsDown(): 
pos = self.ClientToScreen(evt.GetPosition()) 
newPos = (pos.x - self.delta.x, pos.y - self.delta.y 


) 
self .Move(newPos ) 
def OnLeftUp(self, evt):#4 和 鼠标 释放 
if self.HasCapture(): 
self.ReleaseMouse() 
if name == ' main ': 


app = wx.PySimpleApp() 
ShapedFrame( ).Show() 
app.MainLoop() 


H1 我 们 为 三 个 事件 增加 了 相应 的 处 理 器 ， 以 作 相 应 的 工作 。 这 三 个 事件 是 鼠标 左 键 
按 下 ， 和 鼠标 左 键 释放 和 和 鼠标 移动 。 


#2 拖 动 事件 从 鼠标 左 键 按 下 开始 。 这 个 事件 处 理 器 做 两 件 事 。 首 先 它 捕获 这 个 鼠 
标 ， 直 到 鼠标 被 释放 ， 以 防止 鼠标 事件 被 改善 到 其 它 窗口 部 件 。 第 二 ， 它 计算 事件 
发 生 的 位 置 和 窗口 左上 角 之 间 的 偏 移 量 ， 这 个 偏 移 量 将 被 用 来 计算 窗口 的 新 位 置 。 


H3 这 个 处 理 器 当 鼠标 移动 时 被 调用 ， 它 首先 检查 看 该 事件 是 否 是 一 个 鼠标 堪 键 按 
下 ， 如 果 是 ， 它 使 用 这 个 新 的 位 置 和 前 面 计 算 的 偏 移 量 来 确定 窗口 的 新 位 置 ， 并 移 
动 窗口 。 


#4 当 和 鼠标 堪 键 被 释放 时 ，ReleaseMouse() 被 调用 ， 这 使 得 鼠标 事件 又 可 以 被 发 送 
到 其 它 的 窗口 部 件 。 


这 个 拖 动 技术 可 以 被 完善 以 适合 其 它 的 需要 。 例 如 ， 仅 在 一 个 定义 的 区 域内 鼠标 项 
击 才 开始 一 个 拖 动 ， 你 可 以 对 鼠标 按 下 事件 的 位 置 做 一 个 测试 ， 使 敲 击发 生 在 右边 
的 位 置 时 ， 才 能 拖 动 。 


使 用 分 割 窗 


分 割 窗 是 一 种 特殊 的 容器 窗口 部 件 ， 它 管理 两 个 子 窗口 。 这 这 两 个 子 窗口 可 以 被 水 平 
的 堆放 或 彼此 左右 相 邻 。 在 两 个 子 窗口 之 间 的 是 一 个 窗 框 ， 它 是 ME due 
框 ， 移 动 它 就 改变 了 两 个 子 窗 口 的 尺寸 。 分 割 窗 经 常 被 用 于 主 窗 口 的 侧 边 栏 
8.10 显 示 了 一 个 分 割 窗 的 样板 。 


当 你 有 两 个 信息 面板 并 且 想 让 用 户 自 主 决 定 每 个 面板 的 尺寸 时 ， 可 以 使 用 分 割 窗 。 
Mac OS X Finder 窗 口 就 是 一 个 分 割 窗 的 例子 ， 并 且 许 多 的 文本 编辑 器 或 制图 软件 
都 用 它 来 维护 一 个 打开 的 文件 的 列表 。 


创建 一 个 分 割 窗 


ue Saas 分 割 窗 是 类 wx.SplitterWindow 的 实例 。 和 大 多 数 其 它 的 wxPython 
窗口 部 件 不 一 Ve 隔 窗口 在 被 创建 后 ， 可 使 用 前 要 求 进一步 的 初始 化 。 它 的 构造 
a 
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Figure 8.10 A sample splitter window after initialization 


wx.Splitterwindow(parent, id=-1, pos=wx.DefaultPosition, 
size=wx.DefaultSize, style=wx.SP_3D, 
name-"splitterWindow") 


它 的 这 些 参 数 都 有 标准 的 含义 一 parent 是 窗口 部 件 的 容器 ，pos 是 窗口 部 件 在 它 
的 父 容器 中 位 置 ，size 是 它 的 尺寸 。 


在 创建 了 这 个 分 割 窗 后 ， 在 它 可 以 被 使 用 前 ， 你 必须 对 这 个 窗口 调用 三 个 方法 中 的 
一 处 。 如 果 你 想 初 始 时 只 显示 一 个 子 窗口 ， 那 么 调用 Initialize(window)， 参 数 
Window 是 这 个 单一 的 子 窗口 (通常 是 一 种 wx.Panel) 。 在 这 种 情况 下 ， 窗 口 将 在 以 
后 响应 用 户 的 动作 时 再 分 割 。 


要 显示 两 个 子 窗口 ， 使 用 SplitHorizontally (window1，window2，sashPosition=0) 
或 SplitVertically(window1, window2, sashPosition=0)。 两 个 方法 的 工作 都 是 相似 
的 ， 参 数 window1 和 window2 包 含 两 个 子 窗口 ， 参 数 SsashPosition 包含 分 割 条 的 初 
始 位 置 。 对 于 水 平分 割 (KATAR) 来 说 ，window1 被 放置 在 window2 的 顶部 。 
如 果 sashPosition 是 一 个 正 数 ， 它 代表 顶部 窗口 的 初始 高 度 (也 就 是 分 割 条 距 顶 部 
的 像素 值 ) 。 如 果 sashPosition 是 一 个 负数 ， 它 定义 了 底部 窗口 的 尺寸 ， 或 分 割 条 
距 底部 的 像素 值 。 如 果 sashPosition 是 0， 那 么 这 个 分 割 条 位 于 正中 。 对 于 垂直 分 割 
(HEDA) ，window1 位 于 左边 ，window2 位 于 右边 。 正 值 的 sashPosition 设 
置 Window1 的 尺寸 ， 也 就 是 分 割 条 距 左 边框 的 像素 值 。 类 似 的 ， 负 值 sashPosition 
设置 右边 子 窗口 的 尺寸 ，0 值 将 分 割 条 放置 在 正中 。 如 果 你 的 子 窗口 复杂 的 话 ， 我 
们 建议 你 在 布局 中 使 用 sizer， 以 便于 当 分 割 条 被 移动 时 很 好 地 调整 窗口 的 大 小 。 


一 个 分 割 窗 的 例子 

例 8.12 显 示 了 如 何 创建 有 一 个 子 窗口 的 分 割 窗 并 且 在 以 后 响应 菜单 项 的 分 割 。 这 个 

例子 也 使 用 了 一 些 事件 ， 这 些 事件 我 们 以 后 讨论 。 注 意 ， 我 们 不 计划 在 开始 可 见 的 

子 面板 使 用 Hide() 方 法 来 隐藏 。 我 们 这 样 做 是 因为 我 们 开始 时 不 告诉 分 割 窗 去 管理 
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那个 子 面板 的 尺寸 和 位 置 ， 所 以 我 们 使 用 这 种 方法 来 隐藏 它 。 如 果 我 们 在 开始 就 要 
分 割 和 显示 这 两 个 子 面 板 ， 那 么 我 们 就 不 必 考 虑 这 些 。 


例 8.12 如 何 创 建 你 自己 的 分 割 窗 


import wx 


class SplitterExampleFrame(wx.Frame): 
def _ init (self, parent, title): 
wx.Frame. (init (self, parent, title=title) 
self .MakeMenuBar ( ) 
self.minpane = 0 
self.initpos = 0 
self.sp = wx.SplitterWindow(self)# 创建 一 个 分 害 窗 
self.pi = wx.Panel(self.sp, style=wx.SUNKEN_BORDER)# 创建 
子 面板 
self.p2 = wx.Panel(self.sp, style-wx.SUNKEN BORDER) 
self.pi.SetBackgroundColour("pink") 
self.p2.SetBackgroundColour("sky blue") 
self.p1.Hide()# 确保 备用 的 子 面板 被 隐藏 
self .p2.Hide() 


self.sp.Initialize(self.p1)# 初始 化 分 割 窗 


self.Bind(wx.EVT SPLITTER SASH POS CHANGING, 
self.OnSashChanging, self.sp) 

self.Bind(wx.EVT SPLITTER SASH POS CHANGED, 
self.OnSashChanged, self.sp) 


def MakeMenuBar(self): 
menu = wx.Menu() 
item = menu.Append(-1, "Split horizontally") 
self.Bind(wx.EVT MENU, self.OnSplitH, item) 
self.Bind(wx.EVT Update UI, self.OnCheckCanSplit, item) 
item = menu.Append(-1, "Split vertically") 
self.Bind(wx.EVT MENU, self.OnSplitV, item) 
self.Bind(wx.EVT Update UI, self.OnCheckCanSplit, item) 
item - menu.Append(-1, "Unsplit") 
self.Bind(wx.EVT MENU, self.OnUnsplit, item) 
self.Bind(wx.EVT Update UI, self.OnCheckCanUnsplit, item 


menu.AppendSeparator ( ) 

item = menu.Append(-1, "Set initial sash position") 
self.Bind(wx.EVT MENU, self.OnSetPos, item) 

item = menu.Append(-1, "Set minimum pane size") 
self.Bind(wx.EVT MENU, self.OnSetMin, item) 


menu.AppendSeparator() 
item - menu.Append(wx.ID EXIT, "E ") 
self.Bind(wx.EVT MENU, self.OnExit, item) 


mbar = wx.MenuBar() 
mbar.Append(menu, "Splitter" ) 
self .SetMenuBar (mbar) 


def OnSashChanging(self, evt): 
print "OnSashChanging:", evt.GetSashPosition() 


def OnSashChanged(self, evt): 
print "OnSashChanged:", evt.GetSashPosition() 


def OnSplitH(self, evt):# 响应 水 平分 割 请 求 
self.sp.SplitHorizontally(self.p1, self.p2, self.initpos 


def OnSplitV(self, evt):# 响应 垂直 分 割 请 求 
self.sp.SplitVertically(self.p1, self.p2, self.initpos) 


def OnCheckCanSplit(self, evt): 
evt.Enable(not self.sp.IsSplit()) 


def OnCheckCanUnsplit(self, evt): 
evt.Enable(self.sp.IsSplit()) 


def OnUnsplit(self, evt): 
self.sp.Unsplit() 


def OnSetMin(self, evt): 

minpane = wx.GetNumberFromUser( 
"Enter the minimum pane size", 
"", "Minimum Pane Size", self.minpane, 
0, 1000, self) 

if minpane !- -1: 
self.minpane - minpane 
self.sp.SetMinimumPaneSize(self.minpane) 


def OnSetPos(self, evt): 

initpos - wx.GetNumberFromUser( 

"Enter the initial sash position (to be used in the 
Split call)", 

"", "Initial Sash Position", self.initpos, 
-1000, 1000, self) 

if initpos !- -1: 
self.initpos - initpos 


def OnExit(self, evt): 
self.Close() 


app = wx.PySimpleApp(redirect-True) 

frm = SplitterExampleFrame(None, "Splitter Example") 
frm.SetSize( (600, 500) ) 

frm.Show( ) 

app .SetTopWindow( frm) 

app .MainLoop( ) 


分 割 窗 只 能 分 割 一 次 ， 对 已 分 割 的 窗口 再 分 割 将 会 失败 ， 从 而 导致 分 割 方法 返回 
False (成 功 时 返回 True ) ”要 确定 窗口 当前 是 否 被 分 害 了 ， 调 用 方法 IsSSplit()。 在 
例 8.12 中 ， 为 了 确保 相应 的 菜单 项 有 效 ， 就 采用 这 个 方法 。 


如 果 你 想 不 分 割 窗 口 ， 那 么 使 用 UnsplittoRemove= -None) » A ZttoRemove € 3: Fs 
要 移 除 的 wx.Window 对 象 ， 并 且 必 须 是 这 两 个 子 窗 口中 的 一 个 。 如 果 toRemove 是 
> as 么 底部 或 右 部 的 窗口 将 被 移 除 ， 这 根据 分 割 的 方向 而 定 。 默 认 情 况 下 ， 被 
除 的 窗口 是 没有 被 wxPython 删 除 的 ， 所 以 以 后 你 可 以 再 把 它 添加 回来 。Uunsplit 方 
法 在 取消 分 割 成 功 时 返回 True。 如 果 分 割 窗 当前 没有 被 分 割 ， 或 tobRemove 参 数 不 
是 两 个 子 窗口 中 的 一 个 ， 那 么 该 方法 返回 False。 


要 确保 你 对 想 要 的 子 窗口 有 一 个 正确 的 引用 ， 那 么 使 用 GetWindow1() 和 
GetWindow2() 方 法 。GetWindow1() 方 法 返回 顶部 或 左边 的 子 窗口 ， 

而 GetWindow2() 方 法 返回 底部 或 右边 的 窗口 。 由 于 没有 一 个 直接 的 设置 方法 来 改变 
一 个 子 窗口 ， 所 以 使 用 方法 ReplaceWindow(winOld, winNew)，winOld 是 你 要 替换 
的 wx.Window 对 象 ，winNew 是 要 显示 的 新 窗口 。 


改变 分 割 的 外 观 


有 许多 样式 标记 用 来 控制 显示 在 屏幕 上 的 分 割 窗 的 外 观 。 注 意 ， 由 于 分 割 与 平台 有 
关 ， 所 以 不 是 所 有 列 出 的 标记 都 将 对 任何 平台 起 作用 。 表 8.9 说 明了 这 些 有 效 的 标 
记 。 

我 们 将 在 接 下 来 的 部 分 看 到 ， 你 也 可 以 用 你 的 程序 来 改变 分 割 的 显示 ， 以 响应 用 户 
的 动作 或 你 自己 的 要 求 。 


表 8.9 分 割 窗 的 样式 


wx.SP_3D 绘制 三 维 的 边框 和 分 割 条 。 这 是 一 个 默认 样式 。 


wx.SP 3DBORDER 绘制 三 维 样式 的 边框 ， 不 包括 分 
wx.SP_3DSASH 绘制 三 维 样式 的 分 割 条 ， 不 包括 边框 。 
wx.SP_BORDER 绘制 窗口 的 边框 ， 非 三 维 的 样式 。 


改变 响应 分 割 条 移动 的 默认 行为 。 如 果 没 有 设置 
这 个 标记 ， 那 么 当 用 户 拖 动 分 割 条 时 ， 将 绘制 一 
条 线 来 标明 分 割 条 的 新 位 置 。 子 窗 Led ew 
被 实际 地 更 新 ， 直 到 完成 分 割 条 拖 放 。 如 果 设 置 

了 这 个 标记 ， 那 么 当 分 割 条 在 被 拖 动 时 ， ($4 
的 尺寸 将 不 断 地 变化 。 


wx.SP_NOBORDER 不 绘制 任何 边框 。 


在 Windows XP 系统 下 ， 分 割 条 不 使 用 XP 的 主题 
样式 ， 它 给 窗口 一 个 更 经 典 的 外 观 。 


如 果 设 置 了 这 个 样式 ， 那 么 窗口 始终 不 被 分 割 。 
wx.SP_PERMIT_UNSPLIT ”如 果 不 设置 ， 你 可 以 通过 设置 大 于 0 的 最 小 化 的 
窗 格 尺寸 来 防止 窗口 被 分 割 。 


wx.SP_LIVE_Update 


wx.SP NO XP. THEME 
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一 旦 分 割 窗 被 创建 ， 你 就 可 以 使 用 窗口 的 方法 来 处 理 分 割 条 的 位 置 。 特 别 是 ， 你 可 
以 使 用 方法 SetSashPosition(position， redraw=True) 来 移动 分 割 条 HUC 以 像 
素 单位 的 新 的 位 置 ， 它 是 分 害 条 距 窗口 顶部 或 左边 的 距离 。 用 在 分 割 方法 中 的 负 
值 ， 表 示 位 置 从 底部 引 或 右边 算 起 o te -Rredraw A True ， 则 窗口 立即 更 新 。 否 则 它 等 
待 常规 窗口 的 刷新 。 如 果 你 的 像素 值 在 范围 外 的 话 ， 设 置 方法 的 行为 将 不 被 定义 。 
要 得 到 当前 分 割 条 的 位 置 ， 使 用 GetSashPosition() 方 法 。 


在 默认 的 分 割 行 为 下 ， 用 户 可 以 在 两 个 边框 间 随 意 移 到 分 割 条 。 移 动 分 割 条 到 一 

边 ， 便 得 别 一 子 留 口 的 尺寸 为 0， 这 导致 窗口 此 时 成 未 分 割 状态 。 要 防止 这 x fb fA 

况 ， 你 可 以 使 用 方法 SetMinimumPaneSize(paneSize) 来 指定 子 窗口 的 最 小 尺寸 。 

a ee 
]、， 程 序 同样 也 不 能 使 子 窗口 更 小 。 如 前 所 述 ， 你 可 以 使 用 

wx.SP_PERMIT_UNSPLIT 样 式 来 达到 相同 的 效果 。 要 得 到 当前 最 小 子 窗口 尺寸 ， 

使 用 方法 GetMinimumPaneSize()。 


变 窗 口 的 分 割 模式 ， 使 用 方法 SetSplitMode(mode)， 参 数 mode 取 下 列 常 量 值 之 

: WX.SPLIT_VERTICAL、wx.SPLIT_HORIZONTAL。 如 果 模 式 改 变 了 ， 那 么 顶 
FERRALI WAHT ED (反之 亦 然 ) 。 该 方法 不 引起 窗 口 的 重 给 ， 你 必 
须 显 LAUR AT HB 制 重 绘 。 你 可 以 使 用 GetSplitMode() 来 得 到 当前 的 分 割 模式 ， 它 返 
回 上 面 两 个 常量 值 之 一 。 如 果 窗 窗口 当前 是 未 分 割 状态 ， 那 么 GetSplitMode() 方 法 返 
回 最 近 的 分 割 模式 。 


AAJ ^ to Rwx.SP_LIVE_Updatet# AXA dici E > AB uis 窗口 仅 在 分 割 条 拖 动 会 
和 结束 时 改变 尺寸 。 如 果 你 想 在 其 它 时 刻 强 制 子 窗口 重 绘 ， 你 可 以 使 用 方法 
UpdateSize() ° 


响应 分 割 事件 


分 AERE 这 儿 有 四 个 不 同 的 分 割 窗 的 事件 类 型 ， 如 表 
8.10 所 示 


表 8.10 分 割 窗 的 事件 类 型 


当 分 割 条 被 双击 时 触发 。 捕 捉 这 
个 事件 不 阻塞 标准 的 不 分 割 行 
3 除非 你 调用 事件 的 Veto() 方 
法 。 


分 割 条 的 改变 结束 后 触发 ， 但 在 
此 之 前 ， 改 变 将 在 屏幕 上 显示 
(因此 你 可 以 再 作用 于 它 ) 。 这 
个 事件 可 以 使 用 Veto() 来 中 断 。 


当 分 割 条 在 被 拖 动 时 ， 不 断 触 发 
wad 这 个 事件 可 以 通过 使 用 
EVT SPLITTER SASH POS CHANGING ， 事件 的 Veto() 方 法 来 中 断 ， 如 果 
被 中 断 ， 那 么 分 割 条 的 位 置 不 被 
改变 。 


EVT_SPLITTER_UNSPLIT 变 成 未 分 割 状态 时 触发 。 


EVT_SPLITTER_DCLICK 


EVT_SPLITTER_SASH_POS_ CHANGED 


这 个 分 割 事件 类 是 wxX. P ao 从 分 割 事件 的 实例 ， 你 可 以 访问 关 
于 分 割 窗 当 前 状态 的 信息 。 对 于 涉及 到 分 割 条 移动 的 两 个 事件 ， 调 

f] GetSashPosition()4 得 到 分割 条 相对 于 堪 或 顶部 的 位 置 ， 这 依据 分 割 条 的 方向 而 
定 。 在 位 置 正 在 变化 事件 中 ， 调 用 SetSashPosition(pos)， 将 用 线条 表示 新 的 位 
置 。 在 位 置 已 改变 事件 中 ，SetSashPosition(pos) 方 法 将 移动 分 割 条 。 对 于 双击 事 
件 ， 你 可 以 使 用 事件 的 GetX() 和 GetY() 方 法 得 到 项 击 的 确切 位 置 。 对 于 未 分 割 事 
件 ， 你 可 以 使 用 GetWindowBeingRemoved() 方 法 来 得 到 哪个 窗口 被 移 除 了 。 


本 章 小 结 


1、WwxPython 中 的 大 部 分 用 户 交互 都 发 生 在 wx.Frame 或 wx.Dialog 中 。wx.Frame 代 
表 用 户 调 用 的 窗口 。wx.Frame 实 例 的 创建 就 像 其 它 的 wxPython 窗 口 部 件 一 样 。 
wx.Frame 的 典型 用 法 包括 创建 子 类 ， 子 类 通过 定义 子 窗口 部 件 ， 布 局 和 行为 来 扩展 
基 类 。 通 常 ， 一 个 框架 包含 只 包含 一 个 wx.Panel 的 顶级 子 窗 口 部 件 或 别 的 容器 窗 
Wo 


2、 这 儿 还 有 各 种 特定 于 wx.Frame 的 样式 标记 。 其 中 的 一 些 影响 框架 的 尺寸 和 形 
状 ， 另 一 些 影响 在 系统 中 相对 于 其 它 的 框架 ， 它 将 如 何 被 绘制 ， 还 有 一 些 定 义 了 在 
框架 边框 上 有 那些 界面 装饰 。 在 某 种 情况 下 ， 定 义 一 个 样式 标记 需要 “两 步 " 的 创建 
过 程 。 


3、 通 过 调用 Close() 方 法 可 以 产生 关闭 框架 的 请 求 。 这 给 了 框架 一 个 关闭 它 所 占用 
的 资源 的 机 会 。 框 架 也 能 否决 一 个 关闭 请 求 。 调 用 Destroy() 方 法 将 迫使 框架 立即 消 
失 而 没 有 任何 延缓 。 


4、 框 架 中 的 一 个 特定 的 子 窗 口 部 件 可 以 使 用 它 的 wxPython ID、 名 字 或 它 的 文本 标 
签 来 发 现 。 


5、 通 过 包括 WX.ScrolledWindow 类 的 容器 部 件 可 以 实现 滚动 。 这 儿 有 几 个 方法 来 设 
置 滚动 参数 ， 最 简单 的 是 在 滚动 窗口 中 使 用 sizer， 在 这 种 情况 下 ，WxPython 自 动 
确定 滚动 面板 的 虚拟 尺寸 (virtual size) 。 如 果 想 的 话 ， 虚 拟 尺寸 可 以 被 手动 设 
go 


6、 这 儿 有 一 对 不 同 的 框架 子 类 ， 它 们 允许 不 同 的 外 观 。 类 wx.MDIParentFrame 可 
以 被 用 来 创建 MDI， 而 wx.MiniFrame 可 以 创建 一 个 带 有 较 小 标题 栏 的 工具 框 样式 的 
窗口 。 使 用 SetShape() 方 法 ， 框 架 可 以 呈现 出 非 矩 形 的 形状 。 形 状 的 区 域 可 以 被 任 
何 位 图 定义 ， 并 使 用 简单 的 颜色 掩 码 来 决定 区 域 的 边缘 。 非 矩形 窗口 通常 没有 标准 
的 标题 栏 ， 标 题 栏 使 得 框架 可 以 被 拖 动 ， 但 这 可 以 通过 显 式 地 处 理 鼠 标 事件 来 管 
理 。 


7、 位 于 两 个 子 窗口 间 的 可 拖 动 的 分 割 条 能 够 使 用 wx.SplitterWindow 来 实现 ， 分 割 
条 可 以 被 用 户 以 交互 的 方式 处 理 ， 或 以 编程 的 方式 处 理 (如 果 需 要 的 话 ) e 


在 下 一 章 ， 我 们 将 讨论 对 话 框 ， 它 的 行为 类 似 于 框架 。 


PHILS 通过 对 话 框 让 用 户 选择 


使 用 模式 对 话 框 工 作 

. 使 用 标准 对 话 框 

创建 向 导 

显示 启动 提示 

. 使 用 验证 器 (validator) 来 管理 对 话 框 中 的 数据 
本 章 小 结 


模式 对 话 框 用 于 与 用 户 进行 快速 的 交互 或 在 用 户 可 以 执行 程序 的 下 一 步 之 前 ， 对 话 
框 中 的 信息 必须 被 输入 的 时 候 。 在 wxPython 中 ， 有 几 个 标准 的 函数 用 来 显示 基本 
aan 这 些 对 话 框 包括 警告 框 ， 单行 文本 域 ， 和 从 列表 中 选择 。 在 随后 的 

， 我 们 将 给 你 展示 这 些 对 话 框 ， 以 及 如 何 使 用 这 些 预定 义 的 函数 来 减轻 你 的 工 
ped o 


pape ap 


如 何 创建 一 个 模式 对 话 框 ? 


模式 对 话 框 阻塞 了 别 的 窗口 部 件 接收 用 户 事件 ， 直 到 该 模式 对 话 框 被 关闭 ; 4&6) 
说 ， 在 它 存 在 期 间 ， 用 户 一 直 被 置 于 对 话 模 式 中 。 如 图 9.1 所 示 ， 你 不 能 总 是 根据 外 
观 来 区 别 对 话 框 和 框架 。 在 wxPython 中 ， 对 话 框 与 框架 间 的 区 别 不 是 基于 它们 的 
外 观 的 ， 而 主要 是 它们 处 理事 件 的 办 法 的 实质 。 


图 9.1 一 个 模式 对 话 框 


‘Dialog Subclass t3 





Figure 9.1 
A sample modal dialog 


对 话 框 的 创建 和 配置 与 框架 稍微 有 些 不 同 。 例 9.1 显 示 了 产生 图 9.1 的 代码 。 所 显示 
的 对 话 框 上 的 按钮 被 敲 击 后 ， 该 对 话 框 就 关闭 了 ， 并 且 一 条 消息 被 输出 
到 stdout( 标准 输出 )。 


例 9.1 定义 一 个 模式 对 话 框 


import wx 


class SubclassDialog(wx.Dialog): 
def _ init (self):ss 5165 iE 3E 
wx.Dialog. init (self, None, -1, 'Dialog Subclass', 
Size-(300, 100)) 
okButton = wx.Button(self, wx.ID OK, "OK", pos=(15, 15)) 
okButton.SetDefault() 
cancelButton - wx.Button(self, wx.ID CANCEL, "Cancel", 
pos=(115, 15)) 


if name == ' main ': 
app = wx.PySimpleApp() 
app.MainLoop() 
dialog = SubclassDialog() 
result = dialog.ShowModal()# 显 示 模 式 对 话 杠 
if result == wx.ID_OK: 
print "OK" 
else: 
print "Cancel" 
dialog.Destroy() 


与 前 一 章 的 wx.Frame 的 例子 比较 ， 这 儿 有 两 个 需要 注意 的 事情 。 

在 ”init 方法 中 ， 按 钮 是 被 直接 添加 到 wx.Dialog ， 而 非 wx.Panel ° @ 
板 在 对 话 框 中 的 使 用 比 在 框架 中 少 的 多 ， 部 分 原因 是 因为 对 话 框 与 框架 相 比 倾向 简 
单 化 ， 但 主要 是 因为 wx.Panel 特性 (标准 系统 背景 和 tab 键 横向 切换 控件 焦 
A) 已 经 默认 存在 于 wx.Dialog 中 。 


要 显示 为 模式 对 话 框 ， 使 用 ShowModal() 方法 。 这 与 用 于 框架 的 的 Show() 方法 
在 对 程序 的 执行 上 有 不 同 的 作用 。 在 调用 ShowModal() 后 你 的 应 用 程序 将 处 于 等 
待 中 ， 直 到 对 话 框 被 取消 。 


模式 将 保持 到 对 话 框 方法 EndModal(retCode) 被 调用 ， 该 方法 关闭 对 话 框 。 参 
数 retCode 是 由 ShowModal() 方法 返回 的 一 个 整数 值 。 典 型 的 ， 应 用 程序 利用 
这 个 返回 值 来 知道 用 户 是 如 何 关闭 对 话 框 的 ， 以 控制 以 后 的 操作 。 但 是 结束 这 个 模 
式 并 没有 销毁 或 其 至 关闭 对 话 框 。 保 持 对 话 框 的 存在 可 能 是 一 件 好 事 ， 因 为 这 意味 
你 可 以 把 用 户 选 择 的 信息 存储 为 对 话 框 实 例 的 数据 成 员 ， 并 且 即 使 在 对 话 框 被 关闭 
后 也 能 从 对 话 框 重新 获得 那些 信息 。 在 接 下 来 的 部 分 ， 我 们 将 看 一 些 我 们 使 用 对 话 
框 处 理 程序 中 用 户 输入 的 数据 的 例子 。 


由 于 例 9.1 中 没有 定义 事件 处 理 器 ， 你 可 能 会 惊奇 对 话 框 是 如 何 响 应 按钮 敲 击 的 。 这 
个 行为 已 经 定义 在 wxDialog 中 了 。 有 两 个 预定 义 的 wxPython ID 号 ， 它 们 在 
对 话 框 中 有 特殊 的 意思 。 当 对 话 框 中 的 一 个 使 用 wx. ID_OK 

ID 的 wx.Button 被 敲 击 时 ， 模 式 就 结束 了 ， 对 话 框 也 关闭 了 ， wx.ID OK 就 
是 ShowModal() 调用 返回 的 值 。 同 样 ， 一 个 使 用 wx.ID CANCEL ID 的 按钮 做 
相同 的 事情 ， 但 是 ShowModal() 的 返回 值 是 wx.ID_CANCEL ° 


例 9.1 显 示 了 处 理 模式 对 话 框 的 一 个 典型 的 方法 。 在 对 话 框 被 调用 后 ， 返 回 值 被 用 
作 if 语句 中 的 测试 。 在 这 种 情况 下 ， 我 们 简单 地 打印 结果 ， 在 更 复杂 的 例子 
中 ， wx.ID OK 将 执行 用 户 在 对 话 框 中 所 要 求 的 动作 ， 如 打开 文件 或 选择 颜色 。 


典型 的 ， 你 在 完成 对 对 话 框 的 使 用 后 ， 你 应 该 显 式 地 销毁 它 。 这 通知 C++ 对 象 它 应 
该 自我 销毁 ， 然 后 这 将 使 得 它 的 Python 部 分 被 作为 垃圾 回收 。 如 果 你 希望 在 你 的 
应 用 程序 中 ， 以 后 再 次 使 用 该 对 话 框 时 不 重建 它 ， 以 加 速 对 话 框 的 响应 时 间 ， 那 么 
你 可 以 保持 对 该 对 话 框 的 一 个 引用 ， 并 当 你 需要 再 次 激活 它 时 ， 简 单 地 调用 它 

的 ShowModal() 方法 。 当 应 用 程序 准备 退出 时 ， 确 保 已 销毁 了 它 ， 否 

则 MainLoop() 将 仍 将 它 作 为 一 个 存在 的 顶级 窗口 ， 并 且 程序 将 不 能 正常 退出 。 


如 何 创建 一 个 警告 框 ? 


经 由 一 个 对 话 框 与 用 户 交 互 的 最 简单 的 三 个 办 法 分 别 是 : wx.MessageDialog * 
它 是 一 个 警告 枉 、 wx.,TextEntryDialog ， 它 提示 用 户 去 输入 一 些 短 的 文 

本 、 wx.SingleChoiceDialog ， 它 使 用 户 能 够 从 一 个 有 效 选项 列表 中 进行 选择 。 
在 接 下 来 的 三 个 小 节 中 ， 我 们 将 论 这 些 简 单 的 对 话 框 。 

消息 对 话 框 显示 一 个 短 的 消息 ， 并 使 用 户 通过 按 下 按钮 来 作 响 应 。 通 常 ， 消 息 框 被 
用 作 去 显示 重要 的 警告 、 yes | no 问题 、 或 询问 用 户 是 否 继续 某 种 操作 。 图 9.2 
显示 了 一 个 典型 的 消息 框 。 


图 9.2 





A Message Box 





» Is this explanation OK? 





Figure 9.2 A standard 
message box, in a yes/ 
no configuration 


使 用 消息 框 是 十 分 的 简单 。 例 9.2 显 示 了 创建 一 个 消息 框 的 两 种 办 法 。 
例 9.2 创建 一 个 消息 框 


import wx 
if | name == "main ": 
app = wx.PySimpleApp() 


eg OE les 
dlg = wx.MessageDialog(None, "Is this explanation OK?", 
'A Message Box', 
wx.YES_NO | wx.ICON QUESTION) 
retCode = dlg.ShowModal() 
if (retCode == wx.ID_YES): 
print "yes" 
else: 
print "no" 
dlg.Destroy() 


# 方法 二 ， 使 用 函数 
retCode = wx.MessageBox("Is this way easier?", "Via Function 


n 
, 


WX.YES NO | wx.ICON QUESTION) 


例 9.2 创 建 了 两 个 消息 框 ， 一 个 在 另 一 个 的 后 面 。 这 第 一 个 方法 是 创建 
类 wx.MessageDialog 的 一 个 实例 ， 并 使 用 ShowModal() 来 显示 它 。 


使 用 wx.MessageDialog 类 


使 用 wx.MessageDialog 的 构造 函数 ， 你 可 以 设置 对 话 框 的 消息 和 按钮 ， 构 造 函 
数 如 下 : 


wx.MessageDialog(parent , message , caption Message box , 


e style = wx.OK | wx.CANCEL , pos = wx.DefaultPosition) 


message 参数 是 实际 显示 在 对 话 框 中 的 文本 。 如 果 消 息 字 符 串 包含 nm 字符 ， 那 么 
文本 将 在 此 换行 。 caption 参数 显示 在 对 话 框 的 标题 栏 中 。 pos 参数 使 你 可 以 
指定 对 话 框 显 示 在 屏幕 上 的 位 置 一 在 微软 windows 下 ， 这 个 参数 将 被 忽略 。 


wx.MessageDialog 的 样式 标记 分 为 两 类 。 第 一 类 控制 显示 在 对 话 框 中 的 按钮 。 
表 9.1 说 明了 这 些 样式 。 


表 9.1 wx.MessageDialog 的 按钮 样式 


包括 一 个 cancel (取消 ) 按钮 。 这 个 按钮 有 一 

个 ID 值 wx.ID CANCEL ° 

在 一 个 wx.YES NO 对 话 框 中 ， No (G) 按钮 是 默认 
的 。 

包括 一 个 OK 按钮， 这 个 按钮 有 一 

个 ID tH wx.ID OK ° 

在 一 个 wx.YES NO 对 话 框 中 ， Yes 按钮 是 默认 的 。 这 
是 默认 行为 。 

包括 Yes 和 No 按钮 ， 各 自 的 rp 值 分 别 

是 wx.ID_YES 和 wx.ID NO 。 


wx . CANCEL 

wx .NO_ DEFAULT 
wx.OK 

wx. YES_ DEFAULT 
wx. YES_NO 


二 套 样式 标记 控制 紧 挨 着 消息 文本 的 图 标 。 它 们 显示 在 表 9.2 中 。 
表 9.2 wx.MessageDialog 的 图 标 样式 


wX.ICON ERROR 表示 一 个 错误 的 图 标 。 
wx.ICON EXCLAMATION 表示 警告 的 图 标 。 
wx.ICON HAND 同 wx.ICON ERROR ° 
wx. ICON INFORMATION 信息 图 标 ， 字 母 j。 
wx. ICON_QUESTION 问号 图 标 。 


最 后 ， 你 可 以 使 用 样式 wx.STAY_ON_TOP 将 对 话 框 显示 在 系统 中 任何 其 它 窗口 的 
上 面 ， 包 括 系 统 窗口 和 wxPython 应 用 程序 窗口 。 


你 在 例 19.2 所 见 到 的 ， 对 话 框 通过 使 用 ShowModal() 被 调用 。 根 据 所 显示 的 按钮 ， 
A E hY 2 雪 果 是 以 下 值 之 一 : wx.ID_OK , wx.ID_CANCEL > wx.ID YES jn 
wx.ID NO 。 如 同 其 它 对 话 框 的 情况 ， 你 通常 使 用 这 些 值 来 控制 程序 的 执行 


使 用 wx.MessageBox() 函数 


例 9.2 中 的 #1 显示 了 一 个 调用 消息 框 的 更 简短 的 方法 。 这 个 便利 的 函 

数 wx.MessageBox() 创建 对 话 框 ， 调 用 ShowModal() ， 并 且 返 回 下 列 值 之 
一 : wx.YES , wx.NO , wx.CANCEL ,或 wx.OK ° Bahn AX 

比 MessageDialog 的 构造 函数 更 简单 ， 如 下 所 示 : 


wx.MessageBox(message, caption="Message", style-wx.OK) 


在 这 个 例子 中 ， 参 数 message , caption , style 的 意思 和 构造 函数 中 的 相 
同 ， 你 可 以 使 用 所 有 相同 的 样式 标记 。 正 如 我 们 贯穿 本 章 将 看 到 的 ， 
在 wxPython 预定 义 的 几 个 对 话 框 都 有 便利 的 函数 。 在 你 为 单一 的 使 用 创建 对 话 框 


的 时 候 ， 你 的 选择 有 一 个 优先 的 问题 。 如 果 你 计划 束缚 住 对 话 框 以 便 多 次 调用 它 ， 
那么 你 可 能 会 优先 选择 去 实例 化 对 象 以 便 你 能 够 束缚 该 引用 ， 而 不 使 用 函数 的 方 
法 ， 尽 管 这 对 于 这 些 简单 的 对 话 框 来 说 ， 所 节约 的 时 间 可 以 忽略 不 计 。 


要 在 你 的 消息 框 中 显示 大 量 的 文本 (例如 ， 终 端 用 户 许 可 证 的 显示 ) ， 你 可 以 使 
用 wxPython 特定 的 类 wx.lib.dialogs.ScrolledMessageDialog ， 它 包含 如 
下 的 构造 函数 : 


wx.lib.dialogs.ScrolledMessageDialog(parent, msg, caption, 
pos-wx.wxDefaultPosition, size-(500,300)) 


这 个 对 话 框 不 使 用 本 地 消息 框 控件 ， 它 根据 别 的 wxPython 窗口 部 件 来 创建 一 个 对 
话 框 。 它 只 显示 一 个 OK 按钮 ， 并 且 没 有 更 多 的 样式 信息 。 

如 何 从 用 户 得 到 短 的 文本 ? 

这 第 二 个 简单 类 型 的 对 话 框 是 wx.TextEntryDialog ， 它 被 用 于 从 用 户 那 里 得 到 
短 的 文本 输入 。 它 通常 用 在 在 程序 的 开始 时 要 求 用 户 名 或 密码 的 时 候 ， 或 作为 一 个 
数据 输入 表单 的 基本 替代 物 。 图 9.3 显 示 了 一 个 典型 的 文本 对 话 框 。 

图 9.3 文本 输入 标准 对 话 框 





Text Entry E3 


What kind of text would you like to enter? 


Defect Value 


OK Canc | 





Figure 9.3 
A text entry standard dialog 


例 9.3 显 示 了 产生 图 9.3 的 代码 


例 9.3 
import wx 
if name == "_ main ": 


app = wx.PySimpleApp( ) 
dialog = wx.TextEntryDialog(None, 
"What kind of text would you like to enter?", 
"Text Entry", "Default Value", style=wx.OK|wx.CANCEL 


if dialog.ShowModal() -- wx.ID OK: 
print "You entered: %s" % dialog.GetValue() 


dialog.Destroy() 


在 前 一 小 节 > 我 们 创建 了 一 个 对 话 框 类 的 实例 ， 在 这 里 ， 我 们 要 用 到 的 对 话 框 类 
是 (—Á€— o 该 类 的 构造 函数 比 简单 消息 对 话 框 要 复杂 一 些 : 


wx.TextEntryDialog(parent, message, caption="Please enter text", 
defaultValue="", style=wx.OK | wx.CANCEL | wx.CENTRE, 
pos=wx.DefaultPosition) 


message 参数 是 显示 在 对 话 框 中 的 文本 提示 ， 而 caption 显示 在 标题 栏 
Po defaultValue 显示 在 文本 框 中 的 默认 值 。 style TAA 
括 wx.OK 和 wx.CANCEL ， 它 显示 适当 的 按钮 。 


JLA wx.TextCtrl 的 样式 也 可 以 用 在 这 里 。 最 有 用 的 应 该 

是 wx.TE PASSWORD ， 它 掩饰 所 输入 的 丨 实 密码 。 你 也 可 以 使 

用 wx.TE MULTILINE 来 使 用 户 能 够 在 对 话 框 中 输入 多 行文 本 ， 也 可 以 使 

用 wx.TE LEFT , wx.TE CENTRE ,和 wx.TE RIGHT 来 调整 所 输入 的 文本 的 对 齐 
位 置 。 


例 9.3 的 最 后 显示 了 在 文本 框 和 对 话 框 之 间 的 另 一 区 别 。 用 户 所 输入 的 信息 被 存储 在 
该 对 话 框 实例 中 ， 并 且 以 后 必须 应 用 程序 获取 。 在 这 种 情况 下 ， 你 可 以 使 用 对 话 框 
的 GetValue() 方法 来 得 到 该 值 。 记 住 ， Cancel (取消 ) 去 退出 
该 对 话 框 ， 这 意味 他 们 不 想 去 使 用 他 所 键入 的 值 。 你 也 可 以 在 程序 中 使 

用 SetValue() 方法 来 设置 该 值 。 


下 面 这 些 是 使 用 文本 对 话 框 的 便利 函数 : 


1^ wx.GetTextFromUser() 2^ wx.GetPasswordFromUser( ) 
3^ wx.GetNumberFromUser ( ) 


其 中 和 例 9.3 的 用 处 最 近似 的 是 wx.GetTextFromUser() 


wx.GetTextFromUser(message, caption="Input text", 
default_value="", parent=None) 


这 里 的 message , caption , default value ,和 

parent 与 wx.TextEntryDialog 的 构造 函数 中 的 一 样 。 如 果 用 户 按 下 Li 该 
函数 的 返回 值 是 用 户 所 输入 的 字符 串 。 如 果 用 户 按 下 Cancel c GAAR 字符 
Bo 


如 果 你 希望 用 户 输入 密码 ， 你 可 以 使 用 wx.GetPasswordFromUser() 函数 


wx.GetPasswordFromUser(message, caption="Input text", 
default_value="", parent=None) 


这 里 的 参数 意义 和 前 面 的 一 样 。 用 户 的 输入 被 显示 为 星 号 ， 如 果 用 户 按 下 OK ， 该 
函数 的 返回 值 是 用 户 所 输入 的 字符 串 。 如 果 用 户 按 下 Cancel ， 该 函数 返回 空 字符 
$ o 


最 后 ， 你 可 以 使 用 wx.GetNumberFromUser() 要 求 用 户 输入 一 个 数字 : 


wx.GetNumberFromUser(message, prompt, caption, value, min=0, 
max=100, parent=None) 


这 里 的 参数 的 意义 有 一 点 不 同 ， message 是 显 在 prompt 上 部 的 任意 长 度 的 消 
息 ， value 参数 是 默认 显示 在 文本 框 中 的 长 整 型 值 。 min 和 max 参数 为 用 户 的 
输入 限定 一 个 范围 。 如 果 用 户 按 下 OK 按钮 退出 的 话 ， 该 方法 返回 所 输入 的 值 ， 并 
转换 为 s 。 如 果 这 个 值 不 外 转换 为 一 个 数字 ， ap 包围 内 ， 那 么 该 函 
数 返 回 -1， 这 意味 如 果 你 将 该 函数 用 于 负数 的 范围 的 话 ， 能 要 考虑 一 个 转换 的 
方法 。 


如 何 用 对 话 框 显 示 选 项 列表 ? 


如 果 给 你 的 用 户 一 个 空 的 文本 输入 域 显得 太 自由 了 ， 那 么 你 可 以 使 
用 wx. a 来 让 他 们 在 一 组 选项 中 作 单 一 的 选择 。 图 9.4 显 示 了 
一 个 例子 。 


图 9.4 一 个 单 选 对 话 框 
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Figure 9.4 A single 
choice dialog 
例 9.4 显 示 了 产生 图 9.4 的 代码 


例 9.4 显示 一 个 选择 列表 对 话 框 


import wx 


if _name__ == "__main_": 
app = wx.PySimpleApp( ) 
choices = ["Alpha", "Baker", "Charlie", "Delta" ] 
dialog = wx.SingleChoiceDialog(None, "Pick A Word", "Choices 


choices) 
if dialog.ShowModal() == wx.ID_OK: 
print "You selected: %s\n" % dialog.GetStringSelection() 


dialog.Destroy() 


wx.SingleChoiceDialog 5443€ Hato T Pp : 


wx.SingleChoiceDialog(parent, message, caption, choices, 
clientData=None, style-wx.OK | wx.CANCEL | wx.CENTRE, 
pos-wx.DefaultPosition) 


message 和 caption 参数 的 意义 与 前 面 的 一 样 ， 分 别 显 示 在 对 话 框 和 标题 栏 

中 。 choices , CLER 呈现 在 对 话 框 中 的 选 

项 。 style 参数 有 三 个 项 ， 这 是 默认 的 ， 分 别 是 OK 按钮 、 Cancle 按钮 和 使 对 
话 框 在 屏幕 中 居中 。 centre 选项 和 pos s Windows 操作 系统 上 不 工作 。 


如 果 你 想 在 用 户 看 见 对 话 框 之 前 ， 设 置 它 的 默认 选项 ， 使 

用 SetSelection(selection) 方法 。 参 数 selection 是 选项 的 索引 值 ， 而 非 实 
际 选择 的 字符 串 。 在 用 户 选 择 了 一 个 选项 后 ， 你 即 可 以 使 

用 GetSelection() 一 一 它 返 回 所 选项 的 索引 值 ， 也 可 以 使 

用 GetStringSelection() 一 一 它 返回 实际 所 选 的 字符 串 ， 来 得 到 它 。 


有 两 个 用 于 单 选 对 话 框 的 便利 函数 。 第 一 个 是 wx.GetsingleChoice ， 它 返回 用 
户 所 选 的 字符 串 : 


wx.GetSingleChoice(message , caption , aChoices , parent = None) 


参数 message , caption ,和 parent 的 意义 和 wx.SingleChoiceDialog 构造 
函数 的 一 样 。 achoices 参数 是 选项 的 列表 。 如 果 用 户 按 下 ， 则 返回 值 是 所 
选 的 字符 串 ， Cancel ， 则 返回 值 是 空 字 符 串 。 这 意味 如 果 空 字符 是 
一 个 有 效 的 选择 的 话 ， 那 么 你 就 不 该 使 用 这 个 函数 。 


第 二 个 是 wx.GetsingleChoiceIndex: 


wx.GetSingleChoiceIndex(message, caption, aChoices, parent=None) 


这 个 函数 与 第 一 个 有 相同 的 参数 ， 但 是 返回 值 不 同 。 如 果 用 户 按 下 OK ， 则 返回 值 
是 所 选项 的 索引 ， 如 果 用 户 按 下 Cancel ， 则 返回 值 是 -1。 


如 何 显示 进度 条 ? 
在 许多 程序 中 ， 程 序 需要 自己 做 些 事情 而 不 受用 户 输 入 的 干扰 。 这 时 就 需要 给 


even ， 以 表明 程序 正在 做 一 些 事情 及 完成 的 进度 。 在 wxPython fe 这 
常 使 用 一 个 进度 条 来 管理 ， 如 图 9.5 所 示 。 


图 9.5 
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Figure 9.5 A sample progress box, 
joined in progress 


例 9.5 显 示 了 产生 图 9.5 的 代码 
例 9.5 生成 一 个 进度 条 


import wx 

if name == "_ main_": 

app = wx.PySimpleApp( ) 

progressMax = 100 

dialog = wx.ProgressDialog("A progress box", "Time remaining 


", progressMax, 
style-wx.PD CAN ABORT | wx.PD ELAPSED TIME | wx.PD R 


EMAINING TIME) 
keepGoing - True 
count - 0 
while keepGoing and count progressMax: 
count - count * 1 


wx.Sleep(1) 
keepGoing - dialog.Update(count) 


dialog.Destroy() 


条 的 所 有 选项 在 构造 函数 中 被 设置 ， 构 造 函 数 如 下 : 


wx.ProgressDialog(title, message, maximum=100, parent=None, 
style=wx.PD_AUTO_HIDE | wx.PD APP MODAL) 


这 些 参 数 不 同 于 其 它 对 话 框 的 。 参 数 title 被 放置 在 窗口 的 标题 
栏 ， message 被 显示 在 对 话 框 中 。 maximum 是 你 用 来 显示 进度 计数 的 最 大 值 。 


表 9.3 列 出 了 特定 于 wx.ProgressDialog 六 个 样式 ， 它 们 影响 条 的 行为 。 


表 9.3 wx.ProgressDialog 的 样式 


如 果 设 置 了 这 个 样式 ， 进 度 条 对 整个 应 用 程序 是 


模式 的 ， 这 将 阻塞 所 有 的 用 户 事件 。 如 果 没 有 设 

.PD APP MODAL A TC AR DR UL NE 

CENSUI DNE 置 这 个 样式 ， 那 么 进度 条 仅 对 它 的 父 窗口 是 模式 
的 。 

wX.PD AUTO HIDE 进度 条 将 自动 隐藏 自身 直到 它 达 到 它 的 最 大 值 。 


在 进度 条 上 放 上 一 个 Cancel 按钮 ， 以 便 用 户 停 


wx.PD CAN ABORT 止 。 如 何 响 应 来 自 该 对 话 框 的 取消 将 在 以 后 说 
BH o 
wx.PD ELAPSED TIME 显示 该 对 话 框 已 经 出 现 了 多 长 时 间 。 


显示 根据 已 花 的 时 间 、 当 前 的 计数 值 和 计数 器 的 
WX.PD-ESTIMATED-TIME 最 大 值 所 估计 出 的 完成 进度 所 需 的 总 时 间 。 


人 
pier " 间 - 已 花 时 间 )。 


要 使 用 进度 条 ， 就 要 调用 它 的 唯一 的 方 
法 Update(value , newmsg ="")° value 参数 是 进度 条 的 新 的 内 部 的 值 ， 调 
用 update 将 导致 让 度 条 根据 新 的 计数 值 与 最 大 计算 值 的 比例 重 绘 。 如 果 使 用 可 选 
的 参数 newmsg ， 那么 进度 条 上 的 文本 消息 将 变 为 该 字符 串 。 这 让 你 可 以 给 用 户 一 
个 关于 当前 进度 的 文本 描述 。 

个 Update() 方法 通常 返回 True 。 但 是 ， 如 果 用 户 通 过 Cancel 按钮 已 经 取 
消 了 该 对 话 框 ， 那 么 下 次 的 Update() 将 返回 False 。 这 是 你 响应 用 户 的 取消 请 
求 的 机 会 。 要 检测 用 户 的 取消 请 求 ， 我 们 建议 你 尽 可 能 频繁 地 Update() ° 


使 用 标准 对 话 框 


大 多 数 操作 系统 都 为 像 文 件 选 择 、 字 体 选 择 和 闫 色 选 择 这 些 任务 提供 了 标准 对 话 

框 。 这 为 平台 提供 了 一 致 感 观 。 你 也 可 以 使 用 来 自 于 wxPython 的 这 些 对话 框 ， 它 
们 也 为 你 的 应 用 程序 提供 了 一 致 的 感 观 。 如 果 你 使 用 wxPython ， 那 么 它 为 你 提供 
了 类 似 的 对 话 框 ， 即 使 所 在 的 平台 没有 提供 系统 对 话 框 。 


如 何 使 用 文件 选择 对 话 框 ? 


在 wxPython 中 ， wx.FileDialog 为 主流 的 平台 使 用 本 地 操作 系统 对 话 框 ， 对 其 
它 操作 系统 使 用 非 本 地 相似 的 外 观 。 微 软 Windows 的 版 本 如 图 9.6 所 示 。 


图 9.6 
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你 可 以 设置 文件 对 话 框 开 始 在 任 一 目录 ， 你 也 可 以 使 用 通配符 过 滤 来 限制 去 显示 某 
种 文件 类 型 。 例 9.6 显 示 了 一 个 基本 的 例子 。 


例 9.6 使 用 wx.FileDialog 


























import wx 
import os 


if _name__ == "__main_": 
app = wx.PySimpleApp( ) 
wildcard = "Python source (*.py)|*.py|" N 
"Compiled Python (*.pyc)|*.pyc|" \ 
"All files ae 2) M rase pd 
dialog - wx.FileDialog(None, "Choose a file", os.getcwd(), 
"wildcard, wx.OPEN) 
if dialog.ShowModal() -- wx.ID OK: 
print dialog.GetPath() 


dialog.Destroy() 


文件 对 话 框 是 我 们 这 章 已 见 过 的 最 复杂 的 对 话 框 ， 它 有 几 个 属性 可 以 通过 编程 的 方 
式 读 写 。 它 的 构造 函数 使 得 你 能 够 设置 它 的 一 些 属性 : 


wx.FileDialog(parent, message="Choose a file", defaultDir="", 
defaultFile="", wildcard="*.*", style=0, 
pos=wx.DefaultPosition) 


message 参数 出 现在 窗口 的 标题 栏 中 。 defaultDir 参数 告诉 对 话 框 初 始 的 时 候 
显示 哪个 目录 。 如 果 这 个 参数 为 空 或 表示 的 目录 不 存在 ， 那 么 对 话 框 开始 在 当前 目 
Ke defaultFile 是 默认 保存 为 的 文件 。 wildcard 参数 使 你 可 以 基于 给 定 的 模 
式 来 过 滤 列 表 ， 使 用 通常 的 和 2? 作为 通配符 。 通 配 符 可 以 是 单个 模式 ， 如 . py 或 格 
Ade 描述 | 模式 | 描述 | 模式 的 一 系列 模式 _ 类似 于 例 9.6 中 所 用 。 





" Python source (. py) |. py | Compiled Python (. pyc) |. pyc | 
e All files (J|" 


如 果 有 一 个 多 个 项 目的 模式 ， 那 么 它们 显示 在 图 9.6 所 示 的 下 拉 菜 单 中 。 pos 参数 
不 保证 被 基本 的 系统 所 支持 。 


E 


wx.FileDialog 的 两 个 最 重要 的 样式 标记 是 wx.OPEN 和 wx.SAVE ， 它 们 表明 
对 话 框 的 类 型 并 影响 对 话 框 的 行为 。 


用 于 打开 文件 的 对 话 框 有 两 个 标记 ， 它 们 进一步 影响 对 话 框 的 行 
为 。 wx.HIDE_READONLY 标记 灰 化 复 选 框 ， 使 用 户 以 只 读 模 式 打 开 文 
TF» wx.MULTIPLE 标记 使 用 户 可 以 在 一 个 目录 中 选择 打开 多 个 文件 。 


保存 文件 对 话 框 有 一 个 有 用 的 标记 wx,.0VERWRITE_PROMPT ， 它 使 得 保存 文件 时 ， 
如 果 有 相同 的 文件 存在 ， 则 提示 用 户 是 否 履 盖 。 


两 种 文件 对 话 框 都 可 以 使 用 wx. CHANGE_DIR 标记 。 当 使 用 这 个 标记 时 ， 文 件 的 选 
择 也 可 改变 应 用 程序 的 工作 目录 为 所 选 文件 所 在 的 目录 。 这 使 得 下 次 文件 对 话 框 打 
开 在 相同 的 目录 ， 而 不 需要 应 用 程序 再 在 别处 存储 该 值 。 


和 本 章 迄 今 为 止 我 人 们 所 见 过 的 其 它 对话 框 不 一 样 ， 文 件 对 话 框 的 属 
性 directory ， filename , style , message ,和 wildcard 是 可 以 通过 方 
法 来 得 到 和 设置 的 。 这 些 方 法 使 用 Get / Set 命名 习惯 。 


在 用 户 退出 对 话 框 后 ， 如 果 返 回 值 是 wx.OK ， 那 么 你 可 以 使 用 方 

法 GetPath() 来 得 到 用 户 的 选择 ， 该 函数 的 返回 值 是 字符 串 形式 的 文件 全 路 径 
名 。 如 果 对 话 框 是 一 个 使 用 了 wx .MULTIPLE 标记 的 打开 对 话 框 ， 则 

用 GetPaths() 代替 GetPath() 。 该 方法 返回 路 径 字符 串 的 一 个 Python 7| 
表 。 如 果 你 需要 知道 在 用 户 选择 时 使 用 了 下 拉 菜 单 中 的 哪个 项 ， 你 可 以 使 

用 GetFilterIndex() ， 它 返回 项 目的 索引 。 要 通过 编程 改变 索引 ， 使 用 方 
法 SetFilterIndex() 。 


这 后 面 的 是 一 个 使 用 文件 对 话 框 的 便利 函数 : 


wx.FileSelector(message, default_path="", default_filename="", 
default_extension="", wildcard="*.*'', flags=0, parent=None, 
x--1, y--1) 


message , default path , default filename ,和 wildcard 参数 意义 与 构 
造 函 数 的 基本 相同 ， 尽 管 参数 的 名 字 不 同 。 flags 参数 通常 被 称 

作 style > default extension 参数 是 保存 为 文件 时 默认 的 后 级 (如果 用 户 没 
有 指定 后 级 的 情况 下 ) 。 如 果 用 户 按 下 OK ， 返 回 值 是 字符 串 形式 的 路 径 名 ， 如 果 
APTF Cancel 则 返回 一 个 空 字符 束 。 


选择 一 个 目录 


如 果 用 户 想 去 选择 一 个 目录 而 非 一 个 文件 ， 使 用 wx.DirDialog ， 它 呈现 一 个 目 
录 树 的 视图 ， 如 图 9.7 所 示 。 


这 个 目录 选择 器 比 文件 对 话 框 简单 些 。 例 9.7 显 示 了 相关 的 代码 。 
例 9.7 显示 一 个 目录 选择 对 话 框 


import wx 
if _name__ == "__main_": 
app = wx.PySimpleApp( ) 
dialog = wx.DirDialog(None, "Choose a directory:", 
style-wx.DD DEFAULT STYLE | wx.DD NEW DIR BUTTON) 
if dialog.ShowModal() -- wx.ID OK: 
print dialog.GetPath() 
dialog.Destroy() 


图 9.7 
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这 个 对 话 框 的 所 有 的 功能 几乎 都 在 构造 函数 中 : 


wx.DirDialog(parent, message="Choose a directory", defaultPath=" 


, 
style-0, pos = wx.DefaultPosition, size = wx.DefaultSize, 
name-"wxDirCtrl") 


由 于 message 参数 显示 在 对 话 框 中 ， 所 以 你 不 需要 一 个 钩子 去 改变 标题 

žo defaultPath 告诉 对 话 框 选 择 的 默认 路 径 ， 如 果 它 为 室 ， 那 么 对 话 框 显示 文 
件 系统 的 根 目 录 。 pos 和 size 参数 在 微软 Windows FAW > name 参数 在 
所 有 的 操作 系统 下 都 被 忽略 。 该 对 话 框 的 样式 标记 wx.DD NEW DIR BUTTON 给 对 
话 框 一 个 用 于 创建 目录 的 一 个 按钮 。 这 个 标记 在 老 版 的 微软 Windows 中 不 工作 。 


wx.DirDialog 类 的 pis , message ,和 style 属性 都 有 相应 


的 get 和 set 方法 。 你 可 以 使 用 方法 来 在 对 话 框 被 调用 后 获取 用 户 
的 选择 。 这 个 对 话 框 也 有 一 个 便利 ay 3% 


wx.DirSelector(message-wx.DirSelectorPromptStr 


, default path="", 
style-0, pos-wxDefaultPosition 


, parent=None) 


所 有 的 参数 和 前 面 的 构造 函数 相同 ho OK 被 按 下 , M] 该 E Ru P EAE AY FA 
串 形 式 的 目录 名 ， 如 果 按 下 Cancel ， 则 返回 空 字符 串 。 


如 何 使 用 字体 选择 对 话 框 ? 


在 wxPython 中 ， 字 体 选 择 对 话 框 与 文件 对 话 框 是 不 同 的 ， 因 为 它 使 用 了 一 个 单独 
的 帮助 类 来 管理 它 所 呈现 的 信息 。 图 9.8 显 示 了 微软 windows 版 的 字体 对 话 框 。 


例 9.8 显示 了 产生 图 9.8 的 代码 ， 并 且 与 前 面 的 对 话 框 例子 看 起 来 也 有 些 不 同 。 
例 9.8 字体 对 话 框 


import wx 


. main . 
app - wx.PySimpleApp() 
dialog - wx.FontDialog(None, wx.FontData()) 
if dialog.ShowModal() -- wx.ID OK: 
data = dialog.GetFontData() 
font = data.GetChosenFont( ) 
ar tt = data.GetColour() 
print 'You selected: "%s", %d points\n' % ( 


font.GetFaceName(), font.GetPointSize()) 
dialog.Destroy() 


if _name_ == " i br 
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Figure 9.8 
A sample font picker dialog 


wx.FontDialog 的 构造 函数 比 前 面 的 那些 简单 的 多 


wx.FontDialog(parent , data) 


你 不 能 为 该 对 话 框 设置 一 个 消息 或 标题 ， 并 且 被 通常 作为 样式 标记 传递 的 信息 被 包 
Af data 参数 中 ， 该 参数 是 类 wx.FontData ° wx.FontData 类 自己 只 有 一 个 
有 用 的 方法 : GetFontData() ， 该 方法 返回 字体 数据 的 实例 。 


wx.FontData 的 实例 使 你 能 够 设置 管理 字体 对 话 框 显示 的 值 ， 并 且 也 能 够 容纳 用 

户 和 输入 的 人 信息。 例如， 在 例 9.8 中 的 代码 调用 了 wx.FontData 实例 的 两 个 get * 方 
法 来 确定 所 选 字体 的 细节 。 wx.FontData 的 构造 函数 没有 参数 一 一 所 有 的 属性 必 

须 通 过 使 用 表 9.4 中 的 方法 来 设置 。 


表 9.4 wx.FontData 的 方法 


GetAllowSymbols() , SetAllowSymbols(allowSymbols) 


GetChosenFont() , SetChosenFont(font) 


GetColour() , SetColour(colour ) 


GetEnableEffects() , EnableEffects(enable) 


GetlInitialFont() , SetInitialFont(Tfont) 


SetRange(min , max) 


决定 是 否 在 对 话 ; 
示 符 号 字体 

(如 dingbats 
数 是 布尔 值 。 只 
在 Windows ¥ 4 
该 属性 的 初始 值 
是 True 。 


以 wx.Font 对 外 
返回 用 户 所 选 的 : 
果 用 户 选择 了 取 : 
返 

回 None ° wx. 
将 在 第 12 章 作 更 
讨论 2 
返回 在 对 话 框 的 ) 
3f 2r PIT 3 085 JR 
色 。 set 方法 他 
预先 设 定 默认 
值 。 get Zik 
个 wx.Colour : 
例 。 set * 方 法 
的 colour 只 能 
个 wx.Colour : 
色 的 字符 串 名 。- 
初始 值 是 black 


在 该 对 话 框 

的 Windows 版 2 
属性 控制 是 否 显 : 
所 选 颜 色 、 中 间 . 
线 通过 、 是 否 带 - 
特性 。 


返回 对 话 框 初 值 | 
( 即 当 前 所 用 的 : 
这 个 属性 可 以 在 : 
的 来 设置 。 它 的 ; 
是 None 。 


设置 字体 尺寸 (; 
效 范 围 。 仅 用 于 . 
的 Windows £2 
48 30-70 * BPR? 
的 限制 。 


|| GetShowHelp() , SetShowHelp() | 如 果 为 True > MAGA ETE A) fk 
软 Windows 版 本 将 显示 一 个 帮助 按钮 。 初 始 值 为 False ||^ 


有 一 个 使 用 字体 对 话 框 的 便利 的 函数 ， 它 回避 了 wx.FontData X: 


wx.GetFontFromUser(parent, fontInit) 


fontInit 参数 是 wx.Font 的 一 个 实例 ， 它 用 作对 话 框 的 初始 值 。 该 函数 的 返回 
值 是 一 个 wx.Font 实例 。 如 用 户 通过 OK 关闭 了 对 话 框 ， 则 方 
法 wx.Font.Ok() 返回 True > 否则 返回 False ° 


如 何 使 用 颜色 对 话 框 ? 


顾 色 对 话 框 类 似 于 字体 对 话 框 ， 因 为 它 使 用 了 一 个 外 部 的 数据 类 来 管理 它 的 信息 。 
图 9.9 显 示 了 这 类 对 话 框 的 微软 版 本 。 


例 9.9 显 示 了 生成 该 对 话 框 的 代码 ， 它 几乎 与 前 面 的 字体 对 话 框 相 同 。 
1919.9 


import wx 


if _name__ == " main ": 
app - wx.PySimpleApp() 
dialog - wx.ColourDialog(None) 
dialog.GetColourData().SetChooseFull(True) 
if dialog.ShowModal() -- wx.ID OK: 
data - dialog.GetColourData() 
print 'You selected: %s\n' % str(data.GetColour().Get()) 
dialog.Destroy() 


Basic colors: 
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Figure 9.9 
A standard wxPython color picker 


用 于 颜色 选择 器 的 wxPython 的 类 是 wx.ColourDialog 。 它 的 构造 函数 很 简单 ， 
没有 太 多 的 参数 : 


——— e 


wx.ColourDialog(parent , data = None) 


data 参数 是 类 wx.ColourData 的 实例 ， 它 比 相 应 字体 的 更 简单 。 它 只 包含 默认 
的 没有 参数 的 构造 函数 和 后 面 的 三 个 属性 : 


1^ GetChooseFull / SetChooseFull(flag) : 仅 在 微软 windows 下 工作 。 当 
设置 后 ， 将 显示 完整 的 对 话 框 ， 包 括 自 定义 颜色 选择 器 。 如 果 不 设置 ， 则 自 定义 闫 
色 选 择 器 不 被 显示 。 


2^ GetColour / SetColour(colour) : 当 图 表 被 关闭 后 ， 调 用 get * 来 看 用 户 
的 选择 。 最 初 它 被 设置 为 black 。 如 果 在 对 话 框 显 示 之 前 设置 了 它 ， 那 么 对 话 框 
最 初 显示 为 该 颜色 。 


3^ GetCustomColour(i) / SetCustomColour(i , colour) :根据 自 定义 的 闫 
色 数组 中 的 索引 i 来 返回 或 设置 元 素 。i 位 于 [0,15] 之 间 。 初 始 时 ， 所 有 的 自 定义 颜色 
都 是 白色 。 


一 个 回避 了 wx.ColorData 的 使 用 颜色 对 话 框 的 便利 骂 数 是 : 
wx.GetColourFromUser(parent , colInit) 


colInit 是 wx.Colour 的 一 个 实例 ， 并 且 当 对 话 框 显示 时 它 是 对 话 框 的 初始 的 
值 。 逻 数 的 返回 值 也 是 一 个 wx.Colour 的 实例 。 如 果 用 户 通过 OK 关闭 了 对 话 
框 ， 那 么 方法 wx,Colour,0K() 返回 True 。 如 果 用 户 通过 Cancel 关闭 了 对 话 
框 ， 那 么 方法 wx.Colour.OK() 返回 False 。 


如 何 使 用 户 能 够 浏览 图 像 ? 


如 果 你 在 你 的 程序 中 做 图 形 处 理 ， 那 么 在 他 们 浏览 文件 树 时 使 用 缩 略 图 是 有 帮助 
的 。 用 于 该 目的 的 wxPython 对 话 框 被 称 
为 wx.lib.imagebrowser.ImageDialog 。 图 9.10 显 示 了 一 个 例子 。 


例 9.10 显 示 了 用 于 该 图 像 浏览 对 话 框 的 简单 的 代码 。 
例 9.10 创建 一 个 图 像 浏览 对 话 框 


import wx 
import wx.lib.imagebrowser as imagebrowser 
if | name == " main "'": 
app - wx.PySimpleApp() 
dialog - imagebrowser.ImageDialog(None) 
if dialog.ShowModal() -- wx.ID OK: 
print "You Selected File: " + dialog.GetFile() 
dialog.Destroy() 


图 9.10 
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Figure 9.10 A typical image dialog browser 


wx.lib.imagebrowser.ImageDialog 类 是 十 分 简单 的 ， 并 有 相对 较 少 的 选项 供 
程序 员 去 设置 。 要 改变 该 对 话 框 的 行为 的 话 ， 请 查阅 改变 显示 的 文件 类 型 
的 Python 源码 。 类 的 构造 函数 要 求 两 个 参数 。 


ImageDialog(parent , set_dir = None) 


set dir 参数 是 对 话 框 显示 时 所 在 的 目录 。 如 果 不 设置 ， 那么 使 用 应 用 程序 当前 
的 工作 目录 。 在 对 话 框 被 关闭 后 ， GetFile() 返回 所 选 文件 的 完整 路 径 字 符 
串 ， GetDirectory() 只 返回 目录 部 分 


创建 向 导 


向 导 是 一 系列 被 链接 在 一 起 的 简单 对 话 框 ， 它 使 得 用 步 地 跟随 它们 。 通 常 它 
们 被 用 于 指导 用 户 的 安装 或 一 个 复杂 的 配置 过 程 。 人 E 


图 9.11 
Simple Wizard t3 
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Figure 9.11 A simple wizard 

sample 

在 wxPython 中 ， 一 个 向 导 是 一 系列 的 页 面 ， 它 由 类 wx.wizard.wizard 的 一 个 
实例 控制 。 向 导 实 例 管理 用 户 的 页 面 切换 事件 。 这 些 页 面 自身 也 是 

类 wx.wizard.WizardPageSimple 或 wx.wizard.WizardPage 的 实例 。 这 两 种 


类 的 实例 ， 它 们 只 不 过 是 附加 了 必要 的 管理 页 面 链接 逻辑 的 wx.Panel 的 实例 。 已 
证 明 这 两 个 实例 之 间 的 区 别 仅 当 用 户 按 下 Next 按钮 

时 。 wx.wizard.WizardPage 的 实例 使 你 能 够 动态 地 决定 浏览 哪 页 

而 wx.wizard.WizardPageSimple 的 实例 要 求 向 导 被 显示 前 ,顺序 被 预先 设置 。 
例 9.11 显 示 了 产生 图 9.11 的 代码 。 


例 9.11 创建 一 个 简单 的 静态 


import wx 
import wx.wizard 


class TitledPage(wx.wizard.WizardPageSimple):#1 创建 页 面 样板 
def _ init (self, parent, title): 
wx.wizard.WizardPageSimple. init__(self, parent) 
self.sizer = wx.BoxSizer(wx.VERTICAL) 
self .SetSizer(self.sizer) 
titleText = wx.StaticText(self, -1, title) 
titleText.SetFont( 
wx.Font(18, wx.SWISS, wx.NORMAL, wx.BOLD)) 
self.sizer.Add(titleText, 0, 
WX.ALIGN CENTRE | wx.ALL, 5) 
self.sizer.Add(wx.StaticLine(self, -1), 0 
WX.EXPAND | wx.ALL, 5) 
if name == " main ": 
app - wx.PySimpleApp() 
wizard = wx.wizard.Wizard(None, -1, "Simple Wizard") 创建 向 
导 实 例 


# 创建 向 导 页 面 


page1 = TitledPage(wizard, "Page 1") 
page2 = TitledPage(wizard, "Page 2") 
page3 = TitledPage(wizard, "Page 3") 
page4 = TitledPage(wizard, "Page 4") 


page1.sizer.Add(wx.StaticText(page1, -1, 
"Testing the wizard") ) 

page4.sizer.Add(wx.StaticText(page4, -1, 
"This is the last page.")) 


#2 创建 页 面 链 接 

wx.wizard.WizardPageSimple Chain(pagei, page2) 
wx.wizard.WizardPageSimple Chain(page2, page3) 
wx.wizard.WizardPageSimple Chain(page3, page4) 
wizard.FitToPage(page1)43 调整 向 导 的 尺寸 


if wizard.RunWizard(page1):#4 运行 向 导 
print "Success" 


wizard.Destroy() 


#1 为 了 便于 移植 的 目的 ， 我 们 创建 了 一 个 简单 的 小 的 页 面 ， 它 包含 了 一 个 静态 文本 
标题 。 通 常情 况 下 ， 这 儿 还 包含 一 些 表 单元 素 ， 可 能 还 有 一 些 要 用 户 输 入 的 数据 。 


#2 wx.wizard.WizardPageSimple Chain() 浆 数 是 一 个 便利 的 方法 ， 它 以 两 个 
页 面 为 参数 相互 地 调用 它们 的 SetNext() 和 SetPrev() 方法 。 


43 FitToSize() 根据 页 面 参 数 及 该 页 链条 上 的 所 有 页 面 调整 向 导 的 大 小 。 该 方法 
只 能 在 页 面 链接 被 创建 后 调用 。 


#4 Os quU ü o 向 叶 在 它 到 达 一 个 没有 下 一 页 的 页 面 时 知道 
去 关闭 。 如 果 用 户 浏览 整个 向 导 并 通 过 按 下 Finish 按钮 退 "um 
i& * RunWizard() Ee €] True ° 


创建 wx.wizard.Wizard 实例 是 使 用 向 导 的 第 一 步 。 其 构造 函数 如 下 : 


wx.wizard.Wizard(parent, id=-1, title=wx.EmptyString, 
bitmap-wx.NullBitmap, pos=wx.DefaultPosition) 


在 这 里 的 parent , id , title , pos 和 wx.Panel 的 意义 相同 。 如 果 设 置 

了 bitmap va， 这 儿 只 有 一 个 样式 标 

iG : wx.wizard.WIZARD EX HELPBUTTON ， 它 显示 一 个 帮助 按钮 。 这 是 一 个 扩展 
的 标记 ， 需 要 使 用 第 8 章 所 说 的 两 步 创建 过 程 。 


通常 ， 你 将 调用 例 9.11 的 #3 中 所 示 的 FitToSize() 来 管理 窗口 的 尺寸 ， 但 是 你 也 
可 以 通过 调用 带 有 一 个 元 组 或 wx .Size 实例 的 SetPageSize() 来 设置 一 个 最 小 
的 尺寸 。 GetPageSize() 方法 返回 当前 的 尺寸 ， 在 这 两 种 情况 下 ， 该 尺寸 仅 用 于 
对 话 框 中 的 单个 的 页 面部 分 ， 而 作为 一 个 整体 的 对 话 框 将 更 大 一 些 。 


你 可 以 管理 该 类 中 的 页 面 。 方 法 GetCurrentPage() 返回 当前 被 显示 的 页 面 ， 如 
果 该 向 导 当 前 没有 被 显示 ， 该 方法 返回 None 。 你 可 以 通过 调 

用 HasNextPage() 和 HasPrevPage() 来 确定 当前 页 是 否 有 下 一 页 或 上 一 页 。 使 
用 RunWizard() 来 运行 该 向 导 ， 如 例 9.11 中 #4 的 说 明 。 


向 导 产 生 的 命令 事件 如 表 9.5 所 示 ， 你 可 以 捕获 这 些 事件 ， 以 便 作 专门 的 处 理 。 这 些 
事件 对 象 属于 类 wx.wizard.WizardEvent ， 它 们 提供 了 两 个 可 用 的 方 

法 。 GetPage() 返回 wx.WizardPage 的 实例 ， 该 实例 在 向 导 事件 产生 时 是 有 
效 ， 而 非 作为 事件 结果 被 显示 的 实例 。 RM P | A 

4 GetDirection() 返回 True > RFR REI > Ap 

4 GetDirection() 返回 False 。 


#9.5 wx.wizard.WizardDialog 的 事件 


当 用 户 按 下 Cancel 按钮 时 产生 。 该 事件 可 


EVT_WIZARD_CANCEL 以 使 用 Veto() 来 否决 ， 这 种 情况 下 ， 对 话 
框 将 不 会 消失 。 

EVT_WIZARD_FINISHED 4 PEF Finish dE42H EE 

EVT WIZARD HELP SH PHP Help 按钮 时 产生 。 

EVT_WIZARD_PAGE_CHANGED 在 页 面 被 切换 后 产生 。 


当 用 户 已 请 求 了 一 个 页 面 切换 时 产生 ， 这 时 
页 面 还 没有 发 生 切 换 。 这 个 事件 可 以 被 否决 

EVT_WIZARD PAGE CHANGING (例如 ， 如 果 页 面 上 有 一 个 必须 被 填写 的 字 
段 ) 。 


wx.wizard.WizardPageSimple 类 被 当 作 一 个 面板 一 样 。 它 的 构造 函数 使 你 可 以 
设置 上 一 页 和 下 一 页 ， 如 下 所 示 : 


wx.wizard.WizardPageSimple(parent = None , prev = None , 
next = None) 


果 你 想 在 构造 器 中 设置 它们 ， 你 可 以 使 用 SetPrev() 和 SetNext() 方法 。 如 
RIRKA > RTEA wx.wizard.wizardPageSimple_Chain() ， 它 设置 两 
页 间 的 链接 关系 。 


向 导 页 的 复杂 版 : wx.wizard.WizardPage ， 稍 微 不 同 。 它 没有 显 式 地 设置 前 一 
页 和 下 一 页 ， 而 是 使 你 能 够 使 用 更 复杂 的 人 区 辑 去 定义 下 一 步 到 哪儿 。 它 的 构造 函数 
如 下 : 


wx.WizardPage(parent, bitmap-wx.NullBitmap, resource=None) 


如 果 bitmap 参数 被 设置 了 ， 那 么 该 参数 覆盖 父 向 导 中 所 设置 的 位 
图 。 resource 参数 从 一 个 wxPython 资源 装载 页 面 。 要 处 理 页 面 逻 辑 ， 就 要 履 
盖 GetPrev() 和 GetNext() 方法 来 返回 你 想 要 向 导 下 一 步 的 位 置 。 该 类 的 一 个 
典型 的 用 法 是 根据 用 户 对 当前 页 的 响应 动态 地 决定 接 下 来 的 页 面 。 


EREAR A 


许多 应 用 程序 都 使 用 启动 提示 来 作为 一 种 向 用 户 介绍 该 程序 的 特性 等 信息 的 方法 。 
& wxPython 中 有 一 个 非常 简单 的 机 制 用 来 显示 启动 提示 。 图 9.12 显 示 了 一 个 提示 
窗口 的 示例 。 


图 9.12 
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Figure 9.12 A sample tip 
window with a helpful message. 


例 9.12 显 示 了 相关 代码 
例 9.12 


import wx 

if _name == " main _": 

app = wx.PySimpleApp() 

provider = wx.CreateFileTipProvider("tips.txt", 0) 
wx.ShowTip(None, provider, True) 


有 两 个 便利 的 函数 用 来 管理 启动 提示 。 第 一 个 如 下 创建 一 个 wx. TipProvider 


wx.CreateFileTipProvider(filename, currentTip) 


filename 是 包含 提示 字符 串 的 文件 的 名 字 。 currentTip 是 该 文件 中 用 于 一 开 
始 显示 的 提示 字符 的 索引 ， 该 文件 中 的 第 一 个 提示 字符 串 的 索引 是 0。 


提示 文件 是 一 个 简单 的 文本 文件 ， 其 中 的 每 一 行 是 一 个 不 同 的 提示 。 空 白 行 被 忽 
did 以 # 开 始 的 行 被 当 作 注释 并 也 被 忽略 。 下 面 是 上 例 所 使 用 的 提示 文件 中 的 内 


ma 


You can do startup tips very easily. Feel the force, 
Luke. 


提示 的 提供 者 ( provider ) 是 类 wx.PyTipProvider 的 一 个 实例 。 如 果 你 需要 
更 细 化 的 功能 ， 你 可 以 创建 你 自己 的 wx.TipProvider 的 子 类 并 履 
i GetTip() Xe 


显示 提示 的 函数 是 wx.ShowTip(): 


wx.ShowTip(parent, tipProvider, showAtStartup) 


parent Æ HU > tipProvider 通常 创建 

É wx.CreateFileTipProvider ° showAtStartup 控制 启动 提示 显示 时 ， 复 选 
框 是 否 被 选择 。 该 函数 的 返回 值 是 复 选 框 的 状态 值 ， 以 便 你 使 用 该 值 来 决定 你 的 应 
用 程序 下 次 启动 时 是 否 显 示 启 动 提示 。 


使 用 验证 器 (validator) 来 管理 对 话 框 中 的 数据 


验证 器 是 一 个 特殊 的 wxPython 对 象 ， 它 简化 了 对 话 框 中 的 数据 管理 。 当 我 们 在 第 
三 章 中 讨论 事件 时 ， 我 们 简要 的 提 及 到 如 果 一 个 窗口 部 件 有 一 个 验证 器 ， 那 么 该 验 
证 器 能 够 被 事件 系统 自动 调用 。 我 们 已 经 见 过 了 几 个 wxPython 窗口 部 件 类 的 构造 
函数 中 将 验证 器 作为 和 参数， 但 是 我 们 还 没有 讨论 它们 。 


验证 器 有 三 个 不 相关 的 功能 : 


1、 在 对 话 框 关闭 前 验证 控件 中 的 数据 2、 自 动 与 对 话 框 传递 数据 3、 验 证 用 户 键入 
的 数据 


=== 如 何 使 用 验证 器 来 确保 正确 的 ? 访 蔬 ?=== 


JRAEI Re wx.Validator 的 子 类 。 父 类 是 抽象 的 ， 不 能 直接 使 用 。 尽 管 在 C++ 
wxwidget 集中 有 一 对 预定 义 的 验证 器 类 ， 但 是 在 wxPython 中 ， 你 需要 定义 你 
自己 的 验证 器 类 。 正 如 我 们 在 别处 所 见 的 ， 你 的 Python 类 需要 继承 

自 Python 特定 的 子 类 : wx.PyValidator ， 并 且 能 够 覆盖 该 父 类 的 所 有 方法 。 
一 个 自 定 义 的 验证 器 子 类 必须 覆盖 方法 Clone() ， 该 方法 应 该 返回 验证 器 的 相同 
的 副本 。 


一 个 验证 器 被 关联 到 你 的 系统 中 的 一 个 特定 的 窗口 部 件 。 这 可 以 用 两 种 方法 之 一 来 
实现 。 第 一 种 方法 ， 如 果 窗 口 部 件 许可 的 话 ， 验 证 器 可 以 被 作为 一 个 参数 传递 给 该 
窗口 部 件 的 构造 函数 。 如 果 该 窗口 部 件 的 构造 函数 没有 一 个 验证 器 参数 ， 你 仍然 可 
以 通过 创建 一 个 验证 器 实例 并 调用 该 窗口 部 件 的 Setvalidator(validator) 方法 
来 关联 一 个 验证 器 。 


要 验证 控件 中 的 数据 ， 你 可 以 先 在 你 的 验证 器 子 类 中 和 履 盖 validate(parent) 方 
ik ^ parent 参数 是 验证 器 的 窗口 部 件 的 父 窗口 (对 话 框 或 面板 ) 。 如 果 必 要 ， 可 
以 使 用 这 个 来 从 对 话 框 中 其 它 窗 口 部 件 得 到 数据 ， 或 者 你 可 以 完全 忽略 该 参数 。 你 
可 以 使 用 self.Getwindow() 来 得 到 正在 被 验证 的 窗口 部 件 的 一 个 引用 。 你 

的 validate(parent) 方法 的 返回 值 是 一 个 布尔 值 。 True 值 表示 验证 器 的 窗口 
部 件 中 的 数据 已 验证 了 。 False 表示 有 问题 。 你 可 以 根据 Validate() 方法 来 使 
用 x.MessageBox() 去 显示 一 个 警告 ， 但 是 你 不 应 该 做 其 它 的 任何 可 以 

在 wxPython 应 用 程序 中 引发 事件 的 事情 。 


validate() 的 返回 值 是 很 重要 的 。 它 在 你 使 用 OK 按钮 (该 按钮 使 
用 wx.ID OK ID ) 企图 关闭 一 个 对 话 框 时 发 挥 作用 。 作 为 对 OK 按钮 敲 击 处 理 
的 一 部 分 ， wxPython 调用 对 话 框 中 有 验证 器 的 窗口 部 件 的 Validate() Sk ° 
如 果 任 一 验证 器 返回 False ， 那 么 对 话 框 不 将 关闭 。 例 9.13 显 示 了 一 个 带 有 验证 
器 的 示例 对 话 框 ， 它 检查 所 有 文本 控件 中 有 无 数据 。 


919.13 检查 所 有 文本 控件 有 无 数据 的 验证 器 


import wx 


about txt = """\ 

The validator used in this example will ensure that the text 
controls are not empty when you press the Ok button, and 
will not let you leave if any of the Validations fail.""" 


class NotEmptyValidator(wx.PyValidator):# 创建 验证 器 子 类 
def _ init (self): 
wx.PyValidator. init (self) 


def Clone(self): 


Note that every validator must implement the Clone() method. 


return NotEmptyValidator() 


def Validate(self, win):#1 使 用 验证 器 方法 
textCtrl = self.GetWindow() 
text = textCtrl.GetValue() 


if len(text) == 
wx .MessageBox("This field must contain some text!", 
"Error") 
textCtrl.SetBackgroundColour ("pink") 
textCtrl.SetFocus() 
textCtrl.Refresh() 
return False 
else: 
textCtrl.SetBackgroundColour( 
wx.SystemSettings GetColour(wx.SYS COLOUR WINDO 
W)) 
textCtrl.Refresh() 
return True 


def TransferToWindow(self): 
return True 


def TransferFromwindow(self): 
return True 


class MyDialog(wx.Dialog): 
def — init (self): 
wx.Dialog. init (self, None, -1, "Validators: validati 
ng") 


# Create the text controls 


about - wx.StaticText(self, -1, about txt) 
name l = wx.StaticText(self, -1, "Name:") 
email l = wx.StaticText(self, -1, "Email:") 


phone 1 wx.StaticText(self, -1, "Phone:") 


)) 
Jp) 
)) 


app 
dlg 


dlg 
dlg. 


app. 


#1 该 方法 测试 基本 的 控件 有 无 数据 。 如 果 没 有 ， 相 应 的 控件 的 背景 色 


#2 使 用 验证 器 


name_t 
email t 


phone t 


wx.TextCtrl(self, 
wx.TextCtrl(self, 


wx.TextCtrl(self, 


# Use standard button IDs 


okay - 


wx.Button(self, wx. 


okay.SetDefault() 


cancel - wx.Button(self, wx. 


4 Layout with sizers 
wx.BoxSizer(wx.VERTICAL) 
sizer.Add(about, ©, wx.ALL, 5) 

sizer.Add(wx.StaticLine(self), 0, wx.EXPAND|wx.ALL, 5) 


sizer - 


validator=NotEmptyValidator ( 


validator=NotEmptyValidator ( 


validator=NotEmptyValidator ( 


ID_OK) 


ID CANCEL) 


fgs - wx.FlexGridSizer(3, 2, 5, 5) 
fgs.Add(name 1l, ©, wx.ALIGN RIGHT) 
fgs.Add(name t, ©, wx.EXPAND) 
fgs.Add(email l, ©, wx.ALIGN RIGHT) 
fgs.Add(email t, 0, wx.EXPAND) 
fgs.Add(phone 1l, ©, wx.ALIGN RIGHT) 
fgs.Add(phone t, 0, wx.EXPAND) 
fgs.AddGrowableCol(1) 


sizer.Add(fgs, 0, wx.EXPAND|wx.ALL, 5) 


btns = wx.StdDialogButtonSizer() 
btns.AddButton(okay) 
btns.AddButton(cancel) 
btns.Realize() 


sizer.Add(btns, 0, wx.EXPAND|wx.ALL, 5) 


self.SetSizer(sizer) 
sizer.Fit(self) 


- MyDialog() 


. ShowModal( ) 


Destroy() 


MainLoop() 


wx.PySimpleApp() 


#2 这 几 行 ， 对 话 框 中 的 每 个 文本 控件 都 关联 一 个 验证 器 
图 9.13 显 示 了 一 个 文本 域 为 空 就 企图 关闭 的 对 话 框 。 


图 9.13 


o 


B 
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The validator used in Pis example wil ensure that the tet 
controls are not empty when you press the Ok button, and 
wil not let you leave F any of the Validations fad 











Figure 9.13 Attempting to 
close an invalid validator 


明确 地 告诉 对 话 框 去 核对 验证 器 的 代码 没有 出 现在 示例 中 ， 因 为 它 是 wxPython ¥ 
件 系 统 的 一 部 分 。 对 话 框 与 框架 之 间 的 另 一 区 别 是 对 话 框 有 内 建 的 验证 器 行为 ， 而 
框架 没有 。 如 果 你 喜欢 将 验证 器 用 于 不 在 对 话 框 内 的 控件 ， 那 么 调用 父 窗口 

的 Validate() 方法 。 如 果 父 窗口 已 设置 

了 wx.WS EX VALIDATE RECURSIVELY 额外 样式 ， 那 么 所 有 的 子 窗 口 

的 Validate() 方法 也 被 调用 。 如 果 任 一 验证 失败 ， 那 么 validate & 

回 False 。 接 下 来 ， 我 们 将 讨论 如 何 将 验证 器 用 于 数据 传输 。 


如 何 使 用 验证 器 传递 数据 ? 

验证 器 的 第 二 个 重要 的 功能 是 ， 当 对 话 框 打开 时 ， 它 自动 将 数据 传送 给 对 话 框 显 
示 ， 当 该 对 话 框 关闭 时 ， 自 动 从 对 话 框 把 数据 传输 到 一 个 外 部 资源 。 图 9.14 显 示 了 
一 个 示例 对 话 框 。 

图 9.14 
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The validator usad in this example shows how the validator 
can be used to transfer dsta to and from each text control 
Lr shown and dismissed 





Figure 9.14 The transferring 
validator—this dialog will 
automatically display entered 
values when closed 


BEMIS > LAREN BES FREPREARFE oF 

ik TransferToWindow() 在 对 话 框 打开 时 自动 被 调用 。 你 必须 使 用 这 个 方法 把 数 
据 放 入 有 验证 器 的 窗口 部 件 。 TransferFromwindow() 方法 在 使 用 ok 按钮 关闭 
对 话 框 窗 口 时 且 数 据 已 被 验证 后 被 自动 调用 。 你 必须 使 用 这 个 方法 来 将 数据 从 窗口 
部 件 移 动 给 其 它 的 资源 。 


数据 传输 必须 发 生 的 事实 意味 着 验证 器 必须 对 一 个 外 部 的 数据 对 象 有 一 些 了 解 ， 如 
例 9.14 所 示 。 在 这 个 例子 中 ， 每 个 验证 器 都 使 用 一 个 全 局 数据 字典 的 引用 和 一 个 字 
典 内 的 对 于 相关 控件 重要 的 关键 字 来 被 初始 化 。 


当 对 话 框 打开 时 ， TransferToWwindow() 方法 从 字典 中 根据 关键 字 读 取 数 据 并 把 
数据 放 入 文本 域 。 当 对 话 框 关 闭 时 ， TransferFromwindow() 方法 反 向 处 理 并 把 
数据 写 入 字典 。 这 个 例子 的 对 话 框 显示 你 传输 的 数据 。 


例 9.14 一 个 数据 传输 验证 器 


import wx 
import pprint 


about txt = """\ 

The validator used in this example shows how the validator 
can be used to transfer data to and from each text control 
automatically when the dialog is shown and dismissed.""" 


class DataxXferValidator(wx.PyValidator):# 声明 验证 器 
def _ init__(self, data, key): 
wx.PyValidator. init (self) 
self.data - data 
self.key - key 


def Clone(self): 


Note that every validator must implement the Clone() method. 


return DataXferValidator(self.data, self.key) 


def Validate(self, win): 没有 验证 数据 
return True 


def TransferTowindow(self):# 对 话 框 打 开 时 被 调用 
textCtrl = self.GetWindow() 
textCtrl.SetValue(self.data.get(self.key, "")) 
return True 


def TransferFromWindow(self):# 对 话 框 关闭 时 被 调用 
textCtrl = self .GetWindow( ) 
self.data[self.key] = textCtrl.GetValue() 
return True 


class MyDialog(wx.Dialog): 
def — init (self, data): 
wx.Dialog. init (self, None, -1, "Validators: data tra 
nsfer") 


# Create the text controls 


about - wx.StaticText(self, -1, about txt) 
name 1l = wx.StaticText(self, -1, "Name:") 
email l - wx.StaticText(self, -1, "Email:") 
phone 1l = wx.StaticText(self, -1, "Phone:") 


# 将 验证 器 与 窗口 部 件 相关 联 
name t = wx.TextCtrl(self, validator-DataXferValidator( 


data, "name")) 

email t - wx.TextCtrl(self, validator-DataXferValidator( 
data, "email")) 

phone t - wx.TextCtrl(self, validator-DataXferValidator( 
data, "phone")) 


4 Use standard button IDs 

okay - wx.Button(self, wx.ID OK) 
okay.SetDefault() 

cancel - wx.Button(self, wx.ID CANCEL) 


# Layout with sizers 

sizer - wx.BoxSizer(wx.VERTICAL) 

sizer.Add(about, ©, wx.ALL, 5) 
sizer.Add(wx.StaticLine(self), 0, wx.EXPAND|wx.ALL, 5) 


fgs = wx.FlexGridSizer(3, 2, 5, 5) 
fgs.Add(name l1, ©, wx.ALIGN RIGHT) 
fgs.Add(name t, ©, wx.EXPAND) 
fgs.Add(email l, ©, wx.ALIGN RIGHT) 
fgs.Add(email t, 0, wx.EXPAND) 
fgs.Add(phone 1l, ©, wx.ALIGN RIGHT) 
fgs.Add(phone t, 0, wx.EXPAND) 
fgs.AddGrowableCol(1) 

sizer.Add(fgs, 0, wx.EXPAND|wx.ALL, 5) 


btns - wx.StdDialogButtonSizer() 
btns.AddButton(okay) 
btns.AddButton(cancel) 

btns.Realize() 

sizer.Add(btns, 0, wx.EXPAND|wx.ALL, 5) 


self.SetSizer(sizer) 
sizer.Fit(self) 


app - wx.PySimpleApp() 


data = { "name" : "Jordyn Dunn" } 
dlg - MyDialog(data) 
dlg.ShowModal() 

dlg.Destroy() 


wx.MessageBox("You entered these values:\n\n" + 
pprint.pformat(data)) 


app.MainLoop() 
对 话 框 中 验证 器 的 传输 数据 方法 的 调用 自动 发 生 。 要 在 非 对 话 框 窗口 中 使 用 验证 器 


来 传输 数据 ， 必 须 调用 父 窗口 部 件 
的 TransDataFromwindow() 和 TransferDataToWindow() 方法 。 如 果 该 窗口 设 


E f wx.WS EX VALIDATE RECURSIVELY 额外 样式 ， 那 么 在 所 有 的 子 窗口 部 件 上 
也 将 调用 该 传输 函数 。 

如 何在 数据 被 键入 时 验证 数据 ? 

在 数据 被 传 给 窗口 部 件 之 前 ， 你 也 可 使 用 验证 器 来 在 用 户 输入 数据 时 验证 所 输入 的 
数据 。 这 是 非常 有 用 的 ， 因 为 它 可 以 防止 将 得 到 的 坏 的 数据 传 入 你 的 应 用 程序 。 图 
9.12 显 示 了 一 个 例子 ， 其 中 对 话 框 的 文本 阐明 了 该 思想 。 

图 9.15 
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The valdator used in fhis example wil validate the ingt on the fly 
instesd of wating until the okay bution is pressed. The first field 
will not allow digts to be typed, the second wall allow anything 
and the third will not allow alphabetic characters to be entered 


Name: no dots here 
Emal anythrg@emthng com 


Phone: | 122.4567] 


[Lok] | cCancel,..) 





Figure 9.15 A validator verifying 
data on the fly 


验证 数据 的 方法 的 自动 化 成 份 少 于 其 它 的 机 制 。 你 必须 显 式 绑 定 验证 器 的 窗口 部 件 
的 字符 事件 给 一 个 函数 ， 如 下 所 示 : 


self.Bind(wx.EVT CHAR , self.OnChar) 
该 窗口 部 件 假 设 事件 源 属 于 验证 器 。 例 9.15 显 示 了 这 个 绑 定 。 


例 9.15 实时 验证 


import wx 
import string 


about_txt = """\ 
The validator used in this example will validate the input on th 
e fly 


instead of waiting until the okay button is pressed. The first 
field 
will not allow digits to be typed, the second will allow anythin 


g 
and the third will not allow alphabetic characters to be entered 


class CharValidator(wx.PyValidator): 
def _ init (self, flag): 
wx.PyValidator. (init (self) 
self.flag - flag 
self.Bind(wx.EVT CHAR, self.OnChar)# 绑 定 字符 事件 


def Clone(self): 


Note that every validator must implement the Clone() method. 


return CharValidator(self.flag) 


def Validate(self, win): 
return True 


def TransferToWindow(self): 
return True 


def TransferFromwindow(self): 
return True 


def OnChar(self, evt):# 数据 处 理 
key = chr(evt.GetKeyCode( )) 


if self.flag -- "no-alpha" and key in string.letters: 
return 

if self.flag -- "no-digit" and key in string.digits: 
return 

evt.Skip() 


class MyDialog(wx.Dialog): 
def — init (self): 
wx.Dialog. init (self, None, -1, "Validators: behavior 
modification") 


# Create the text controls 


about - wx.StaticText(self, -1, about txt) 
name 1l = wx.StaticText(self, -1, "Name:") 

email l - wx.StaticText(self, -1, "Email:") 
phone 1l = wx.StaticText(self, -1, "Phone:") 


# 绑 定 验证 器 


name_t wx. TextCtrl(self, validator-CharValidator("no- 
digit")) 

email_t = wx.TextCtrl(self, validator=CharValidator ("any 
aye) 

phone t = wx.TextCtrl(self, validator=CharValidator ("no- 
alpha") ) 


# Use standard button IDs 

okay = wx.Button(self, wx.ID_OK) 
okay .SetDefault() 

cancel = wx.Button(self, wx.ID CANCEL) 


# Layout with sizers 

sizer - wx.BoxSizer(wx.VERTICAL) 

sizer.Add(about, ©, wx.ALL, 5) 
sizer.Add(wx.StaticLine(self), 0, wx.EXPAND|wx.ALL, 5) 


fgs = wx.FlexGridSizer(3, 2, 5, 5) 


fgs.Add(name_1, ©, wx.ALIGN RIGHT) 
fgs.Add(name t, ©, wx.EXPAND) 
fgs.Add(email l, ©, wx.ALIGN RIGHT) 
fgs.Add(email t, 0, wx.EXPAND) 
fgs.Add(phone 1l, ©, wx.ALIGN RIGHT) 
fgs.Add(phone t, 0, wx.EXPAND) 
fgs.AddGrowableCol(1) 

sizer.Add(fgs, 0, wx.EXPAND|wx.ALL, 5) 


btns = wx.StdDialogButtonSizer() 
btns.AddButton(okay) 
btns.AddButton(cancel) 

btns.Realize() 

sizer.Add(btns, 0, wx.EXPAND|wx.ALL, 5) 


self.SetSizer(sizer) 
sizer.Fit(self) 


app = wx.PySimpleApp() 


dlg - MyDialog() 
dlg.ShowModal() 
dlg.Destroy() 


app.MainLoop() 


由 于 onchar() 方法 是 在 一 个 验证 器 中 ， 所 以 它 在 窗口 部 件 响应 字符 事件 之 间 被 调 
用 。 该 方法 让 你 可 以 通过 使 用 Skip() 来 将 事件 传送 给 窗口 部 件 。 你 必须 调 

用 Skip() ， 和 否则 验证 器 将 妨碍 正常 的 事件 处 理 。 验 证 器 执行 一 个 测试 来 查看 用 于 
该 控件 的 字符 是 否 有 效 。 如 果 该 字符 无 效 ， 那 么 Skip() 不 被 调用 ， 并 且 事 件 处 理 
停止 。 如 果 有 必须 的 话 ， 除 了 wx.EVT_CHAR 之 外 的 其 它 事件 也 可 以 被 绑 定 ， 并 在 
窗口 部 件 响 应 之 前 验证 器 处 理 那些 事件 。 


对 于 处 理 你 wxPython 应 用 程序 中 的 数据 ， 验 证 器 是 一 个 强大 且 灵 活 的 机 制 。 适 当 
地 使 用 它们 ， 可 以 让 你 的 应 用 程序 的 开发 和 维护 更 加 的 顺畅 。 


本 草 小 结 


1、 对 话 框 被 用 于 在 有 一 套 特殊 的 信息 需要 被 获取 的 情况 下 ， 处 理 与 用 户 的 交互 ， 
这 种 交互 通常 很 快 被 完成 。 在 wxPython 中 ， 你 可 以 使 用 通用 的 wx.Dialog 类 来 
创建 你 自己 的 对 话 框 ， 或 者 你 也 可 以 使 用 预定 义 的 对 话 框 。 大 多 数 情 况 下 ， 通 常 被 
使 用 的 对 话 框 都 有 相应 的 便利 函数 ， 使 得 这 种 对 话 框 的 使 用 更 容易 。 


2、 对 话 框 可 以 显示 为 模式 对 话 框 ， 这 意味 在 对 话 框 可 见 时 ， 该 应 用 程序 中 的 用 户 
所 有 的 其 它 输 入 将 被 阻塞 。 模 式 对 话 框 通过 使 用 ShowModal() 方法 来 被 调用 ， 它 
的 返回 值 依据 用 户 所 按 的 按钮 而 定 ( OK 或 Cancel ) 。 关 闭 模 式 对 话 框 并 不 会 
销毁 它 ， 该 对 话 框 的 实例 可 以 被 再 用 。 


3、 在 wxPython 中 有 三 个 通用 的 简单 对 话 框 。 wx.MessageDialog 显示 一 个 消 
息 对 话 框 。 wx.TextEntryDialog 使 用 户 能 够 键入 文 
本 ， wx.SingleChoiceDialog 给 用 户 一 个 基于 列表 项 的 选择 。 


4、 当 正在 执行 一 个 长 时 间 的 后 侣 的 任务 时 ， 你 可 以 使 用 wx.ProgressDialog 来 
给 用 户 显示 进度 信息 。 用 户 可 以 通过 wx.FileDialog 使 用 标准 文件 对 话 框 来 选择 
一 个 文件 。 可 以 使 用 wx.DirDialog 来 创建 一 个 标准 目录 树 ， 它 使 得 用 户 可 以 选 

择 一 个 目录 。 


5、 你 可 以 使 用 wx.FontDialog 和 wx.ColorDialog 来 访问 标准 的 字体 选择 器 和 
颜色 选择 器 。 在 这 两 种 情况 中 ， 对 话 框 的 行为 和 用 户 的 响应 是 由 一 个 单独 的 数据 类 
来 控制 的 。 


6、 要 浏览 缩 略 图 ， 可 以 使 用 wxPython 特定 的 
X wx.lib.imagebrowser.ImageDialog 。 这 个 类 使 用 户 能 够 通过 文件 系统 并 选 
择 一 个 图 像 。 


7、 你 可 以 通过 使 用 wx.wizard.Wizard 创建 一 个 向 导 来 将 一 组 相关 的 对 话 框 表单 
链接 起 来 。 对 话 框 表单 

是 wx.wizard.WizardSimplePage 或 wx.wizard.WizardPage 的 实例 。 两 者 的 

区 别 是 ， wx.wizard.WizardSimplePage 的 页 到 页 的 路 线 需要 在 向 导 被 显示 之 前 
就 安排 好 ， 而 wx.wizard.WizardPage 使 你 能 够 在 运行 时 管理 页 到 页 的 路 线 的 逻 

辑 。 

8、 使 用 wx.CreateFileTipProvider 和 wx.ShowTip 有 子 数 可 以 很 容易 地 显示 局 

动 提示 。 

9、 验 证 器 是 很 有 用 的 对 象 ， 如 果 输 入 的 数据 不 正确 的 话 ， 它 可 以 自动 阻止 对 话 框 


的 关闭 。 他 们 也 可 以 在 一 个 显示 的 对 话 框 和 一 个 外 部 的 对 象 之 间 传 输 数 据 ， 并 且 能 
够 实时 地 验证 数据 的 输入 。 


第 十 章 创建 和 使 用 WXPython 菜 单 


1. 创建 和 使 用 wxPython 菜 单 

ij， 创建 菜单 
i， 如 何 创 建 一 个 菜单 栏 并 把 它 附 加 到 一 个 框架 ? 
i 如何 创建 一 个 菜单 并 把 它 附 加 到 菜单 栏 ? 
i 诈 如何 给 下 拉 菜 单 十 加 项 目 ? 
iv. 如何 响应 一 个 菜单 事件 ? 

ii, 使 用 菜单 项 工作 
i， 如 何在 一 个 菜单 中 找到 一 个 特定 的 菜单 项 ? 
i. 如何 使 一 个 菜单 项 有 效 或 无 效 ? 
ii， 如 何 将 一 个 菜单 项 与 一 个 快捷 键 关联 起 来 ? 
iv， 如 何 创建 一 个 复 选 或 单 选 开 关 菜 单项 ? 


iii. 进一步 构建 菜单 
i， 如 何 创建 一 个 子 菜单 ? 


i 如 何 创建 弹出 式 菜单 ? 

ii， 如 何 创建 自己 个 性 的 菜单 ? 
iv. 菜单 设计 的 适用 性 准则 

i， 使 菜单 有 均衡 的 长 度 

ji， 创建 合理 的 项 目 组 
v. 本 章 小 结 


本 章 内 容 包括 : 
创建 菜单 使 用 菜单 项 工作 添加 子 菜单 、 弹 出 菜单 和 自 定义 菜单 菜单 的 设计 准则 


难以 想象 一 个 应 用 程序 的 顶部 没有 我 们 常见 的 以 File 和 Edit 开头 ， 

以 Help 结尾 的 栏目 。 这 太 糟 糕 了 。 菜 单 是 那些 隐藏 在 背后 并 不 太 重 视 绘 制 的 标准 
界面 工具 的 一 个 公共 的 部 分 ， 由 于 菜单 使 得 用 户 能 够 快速 而 容易 地 访问 所 有 的 功 
能 ， 所 以 它 实 实在 在 是 一 个 革命 。 


在 wxPython 中 有 三 个 主要 的 类 ， 它 们 管理 菜单 的 功能 。 类 wx.MenuBar 管理 菜 
单 栏 自身 ， 而 wx.Menu 管理 一 个 单独 的 下 拉 或 弹出 菜单 。 当 然 ， 一 

个 wx.MenuBar 实例 可 以 包含 多 个 wx.Menu 实例 。 类 wx.MenuItem 代表 一 

个 wx.Menu 中 的 一 个 特定 项 目 。 


在 第 二 章 中 我 们 对 菜单 作 了 一 个 简要 的 介绍 ， 在 例 5.5 中 我 们 提供 了 一 个 容易 创建 菜 


单项 的 机 制 ， 在 第 7 章 中 我 对 特殊 的 菜单 效果 作 了 一 些 介绍 。 在 这 一 章 ， 我 们 将 
对 wxPython 菜单 的 创建 和 使 用 提供 更 多 的 细节 。 


首先 ， 我 们 将 讨论 菜单 栏 。 要 使 用 一 个 菜单 栏 ， 就 要 执行 下 面 这 些 行动 : 


创建 菜单 栏 .把 菜 单 栏 附加 给 SHER .创建 单个 的 菜单 FOR an T 
菜单 .创建 单个 的 菜单 项 :把 这 些 菜单 项 附加 给 适当 的 菜单 :为 每 个 菜单 项 创建 一 个 
事件 绑 定 


上 面 行动 的 执行 顺序 可 以 灵活 点 ， 只 要 你 在 使 用 之 前 创建 所 有 项 目 ， 并 且 所 有 行动 
在 框架 的 初始 化 方法 中 完成 就 可 以 了 。 在 这 个 过 程 中 你 可 以 以 后 来 处 理 菜单 ， 
在 框架 可 见 后 ， 你 的 执行 顺序 将 影响 用 户 所 见 到 的 东西 。 例 如 ， 如 果 你 在 框架 创建 
后 将 菜单 栏 附加 给 框架 ， 或 等 到 直到 所 有 其 它 的 过 程 完成 了 。 考 虑 到 可 读 性 和 维护 
的 目的 ， » 我 们 推荐 你 将 相关 的 部 分 分 整理 在 一 起 。 对 于 如 何 组 织 菜单 的 创建 的 建 

议 ， 请 看 第 5 章 的 重 构 。 在 接 下 来 的 部 分 ， 我 们 将 涉及 基本 的 菜单 任务 。 


如 何 创建 一 个 菜单 栏 并 把 它 附加 到 一 个 框架 
要 创建 一 个 菜单 栏 ， 使 用 wx.MenuBar 构造 函数 ， 它 没有 参数 : 


wx.MenuBar() 


一 旦 菜单 栏 被 创建 了 ， 使 用 SetMenuBar() 方法 将 它 附 加 给 一 个 wx.Frame (或 
其 子 类 ) 。 通 常 这 些 都 在 框架 的 ”init A onInit() 方法 中 实施 : 


menubar = wx.MenuBar() 
self.SetMenuBar 


你 不 必 为 菜单 栏 维护 一 个 临时 变量 ， 但 是 这 样 做 将 使 得 添加 菜单 到 菜单 栏 多 少 更 简 
单 点 。 要 掌握 程序 中 的 其 它 地 方 的 菜单 栏 ， 使 用 wx.Frame.GetMenuBar() ° 


如 何 创 建 一 个 菜单 并 把 它 附 加 到 菜单 栏 ? 
wxPython 菜单 栏 由 一 个 个 的 菜单 组 成 ， 其 中 的 每 个 菜单 都 需要 分 别 被 创建 。 下 面 


显示 了 wx.Menu 494922 BA: 


wx.Menu(title="", style=0) 


对 于 wx.Menu 只 有 一 个 有 效 的 样式 。 在 GTK F > X wx.MENU_TEAROFF 使 得 
菜单 栏 上 的 菜单 能 够 被 分 开 并 作为 独立 的 选择 器 。 在 其 它 平台 下 ， 这 个 样式 没有 作 
E oWREG RH PAR RE OIE TAA — 个 标题 。 图 10.1 显 示 了 一 个 带 有 三 

菜单 的 空白 窗口 。 例 10.1 显 示 了 被 添 到 一 1 菜单 栏 上 的 一 系列 菜单 ， 这 些 菜单 没 
AGE 项 。 


图 10.1 
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Figure 10.1 
A blank window with three menus 


110.1 添加 菜单 到 一 个 菜单 栏 


import wx 


class MyFrame(wx.Frame): 
def _ init (self): 


wx.Frame. init__(self, None, -1, "Simple Menu Example") 


p = wx.Panel(self) 
menuBar = wx.MenuBar()# 创建 一 个 菜单 栏 
menu = wx.Menu()# 创建 一 个 菜单 
menuBar.Append(menu, "Left Menu")# 添加 菜单 到 菜单 栏 
menu2 = wx.Menu() 
menuBar.Append(menu2, "Middle Menu") 
menu3 = wx.Menu() 
menuBar.Append(menu3, "Right Menu") 
self .SetMenuBar (menuBar ) 
if _ name == " main_": 
app = wx.PySimpleApp( ) 
frame = MyFrame() 
frame.Show( ) 
app .MainLoop( ) 


在 wxPython 的 菜单 API 中 ， 一 个 对 象 的 大 部 分 处 理 是 由 它 的 容器 类 来 管理 的 。 
在 本 章 的 后 面 ， 我 们 将 讨论 wx .Menu 的 特定 的 方法 ， 因 为 这 些 方法 的 大 多 数 涉 及 


到 菜单 中 的 菜单 项 的 处 理 。 在 这 一 节 的 剩余 部 分 ， 由 于 我 们 正在 谈论 处 


3€ wx.Menu 对 象 ， 所 以 我 们 将 列 出 wx.MenuBar 的 那些 涉及 到 菜单 的 方法 。 表 


10.1 显 示 了 wx.MenuBar 中 的 四 个 方法 ， 它 们 处 理 菜 单 栏 的 内 容 。 


表 10.1 在 菜单 栏 处 理 菜单 的 wx.MenuBar 的 方法 


将 menu 参数 添加 到 菜单 栏 的 尾部 (HAL 


tele) en ^o) 。 title 参数 被 用 来 显示 新 的 菜单 。 如 果 成 功 到 
回 True » CIAN False 。 
将 给 定 的 menu 插入 到 指定 的 位 置 pos (WARS HAZ 
后 ， GetMenu(pos) == menu eet 。 就 像 在 列表 中 插 
Insert(pos , 入 一 样 ， 所 有 后 面 的 菜单 将 被 右 移 。 菜 单 的 索引 以 0 开始 ， 
menu ， 所 以 pos 为 0 等 同 于 将 菜单 放置 于 菜单 栏 的 左 端 。 使 
title) 用 GetMenuCount() 作为 pos 等 同 于 使 
用 Append ° title RATETA F ° hrt ARJ UA 
回 True e 
Remove(pos) elp ee 的 菜单 ， 之 后 的 其 它 菜单 堪 移 。 函 数 返 回 被 
DER ERU 使 用 给 合 定 的 menu ， 和 title 替换 位 置 pos 处 的 菜单 。 
le 菜单 栏 上 的 其 它 菜单 不 受 影响 。 函 数 返 回 替 换 前 的 菜单 。 
wx.MenuBar 包含 其 它 的 方法 。 它 们 用 另外 的 方式 处 理 菜单 栏 中 的 菜单 ， 如 
表 10.2 所 示 。 


表 10.2 wx.MenuBar 的 菜单 属性 方法 


设置 位 置 pos 处 的 菜单 的 可 用 / 

不 可 用 状态 。 如 
EnableTop(pos , enable) A enable 是 True ° ABA 

菜单 是 可 用 的 ， 如 果 

x False ， 那 么 它 不 可 用 。 


ss 
PSU 


GetMenu(pos) 返回 给 定位 置 处 的 菜单 对 象 。 

GetMenuCount ( ) 返回 菜单 栏 中 的 菜单 的 数量 。 
返回 菜单 栏 有 给 ia title 的 菜 
单 的 整数 索引 。 ae x AE HY 

FindMenu(title) 菜单 ， n 


量 EN o nds 
忽略 快捷 键 ， 如 果 有 的 话 。 


GetLabelTop(pos) , SetLabelTop(pos , 得 到 或 设置 给 定位 置 的 菜单 的 标 
label) A o 


如 何 给 下 拉 菜 单 填 加 项 目 ? 


这 里 有 一 对 机 制 用 于 将 新 的 菜单 项 添加 给 一 个 下 拉 菜 单 。 较 容易 的 是 使 
用 wx.Menu 的 Append() 方法 : 


Append(id, string, helpStr="", kind=wx.ITEM_NORMAL ) 


参数 id 是 一 个 wxPython ID 。 参 数 string 是 将 被 显示 在 菜单 上 的 字符 串 。 
当 某 个 菜单 高 亮 时 ， 如 果 设 置 了 参数 helpstr ， 那 么 该 参数 将 被 显示 在 框架 的 状 
态 栏 中 。 kind 参数 使 你 能 够 设置 菜单 项 的 类 型 ， 通 过 该 参数 可 以 将 菜单 项 设置 为 
开关 类 型 。 在 这 一 章 的 后 面 ， 我 们 将 讨论 管理 开关 项 的 更 好 的 方法 。 Append 方法 
把 新 的 项 放 到 菜单 的 尾部 。 


例 10.2 显示 了 一 个 使 用 Append() 方法 来 建立 一 个 有 两 个 项 链 和 一 个 分 隔 符 的 菜 
单 。 


例 10.2 添加 项 目 到 一 个 菜单 的 示例 代码 


import wx 


class MyFrame(wx.Frame): 
def _init_ (self): 
wx.Frame. init__(self, None, -1, "Simple Menu Example") 
p = wx.Panel(self) 
self.CreateStatusBar() 
menu - wx.Menu() 
simple - menu.Append(-1, "Simple menu item", "This is so 
me help text") 
menu.AppendSeparator() 
exit - menu.Append(-1, "Exit") 
self.Bind(wx.EVT MENU, self.OnSimple, simple) 
self.Bind(wx.EVT MENU, self.OnExit, exit) 
menuBar - wx.MenuBar() 
menuBar.Append(menu, "Simple Menu") 
self.SetMenuBar (menuBar ) 


def OnSimple(self, event): 
wx.MessageBox("You selected the simple menu item") 


def OnExit(self, event): 
self.Close() 
if name == " main ": 
app - wx.PySimpleApp() 
frame - MyFrame() 
frame.Show() 
app.MainLoop() 


El 10.2 显示 了 一 个 带 有 分 隔 符 和 状态 文本 的 菜单 。 
图 10.2 
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Figure 10.2 A sample menu, with separators 
and status text. 


连同 Append() 一 起 ， 这 里 还 有 两 个 另外 的 用 于 菜单 项 播 入 的 方法 。 要 把 一 个 菜 
项 放 在 菜单 的 开头 ， 使 用 下 面 两 个 方法 之 一 : 


: Prepend(id , string , helpStr ="", kind = wx.ITEM NORMAL) 
: PrependSeparator() 


要 把 新 的 项 放 入 菜单 中 的 任 一 位 置 ， 使 用 这 下 面 的 insert 方法 之 一 : 


: Insert(pos , id , string , helpStr ="", kind = wx.ITEM NORMAL) 
* InsertSeparator(pos) 


参数 pos 是 菜单 项 要 插入 的 位 置 的 索引 ， 所 以 如 果 索 引 为 0， 则 新 的 项 被 放置 在 开 
头 ， 如 果 索 引 值 为 菜单 的 尺寸 ， 那 么 新 的 项 被 放置 在 尾部 。 所 以 在 插入 点 后 的 菜 
项 将 被 向 下 移动 。 


所 有 的 这 些 揪 入 方法 都 隐 含 地 创建 一 个 wx.MenuItem 类 的 实例 。 你 也 可 以 使 用 该 
类 的 构造 函数 显 式 地 创建 该 类 的 一 个 实例 ， 以 便 设置 该 菜单 项 的 除 lA 以 外 的 其 
它 的 属性 。 比 如 你 可 以 设置 自 定 义 的 字体 或 颜色 。 wx.Menultem 84434 Bete 
F: 


wx.MenuItem(parentMenu = None , id = ID ANY , text = 
e helpString ="", kind = wx.ITEM NORMAL , subMenu = None) 


参数 parentMenu 必须 是 一 个 wx.Menu 实例 (如 果 人 设置 了 的 话 ) 。 当 构造 时 ， 这 
个 新 的 菜 3 项 不 是 自动 被 添加 到 父 父 菜单 上 显示 的 。 你 必须 自己 来 实现 。 这 个 行为 
wxPython 窗口 部 件 和 它们 的 容器 的 通常 的 行为 不 同 。 参 数 id Cd ds 
v 参数 text 是 新 项 显示 在 菜 Pi EN ale 参数 helpstring 是 当 该 菜单 项 
BRU LAARAE POEEE - kind 是 菜单 项 的 类 型 ， wx.ITEM NORMAL 代 
表 纯 菜单 项 ; 我 们 以 后 会 看 到 TAG 项 有 不 同 的 类 型 值 。 如 果 参 数 subMenu 的 
值 不 是 null ， Tes 文 个 新 的 菜单 项 实际 上 就 是 一 个 子 菜单 。 使 用 这 
个 机 制 来 创建 子 菜 单 ; 替 而 代 之 ， 可 以 使 用 在 10.3 节 中 说 明 的 机 制 来 装扮 你 的 菜 
单 o 
ae! 口 部 件 ， 创 建 菜单 项 并 不 将 它 添加 到 指定 的 父 菜单 。 要 将 新 的 菜 
添加 到 一 个 菜单 中 ， 使 用 下 面 的 wx.Menu 方法 之 一 : 


: AppendItem(aMenuItem) - InsertItem(pos , aMenuItem) 
: PrependItem(aMenuItem) 


要 从 菜单 中 删除 一 个 菜单 项 ， 使 用 方法 Remove(id) ， 它 要 求 一 个 wxPython 
ID ， 或 Removeltem(item) ， 它 要 求 一 个 菜单 项 作为 参数 。 S 项 
后 ' 后 面 的 菜单 项 将 上 移 。 Remove() 方法 将 返回 所 删除 的 实际 的 菜单 项 。 这 使 你 
能 够 存储 该 菜 单项 以 备 后 用 。 与 菜单 栏 不 同 ， 菜 单 没有 直接 替换 菜 电 2 ° 3 
换 必须 通 过 先 删 除 再 插入 来 实现 。 


wx.Menu 类 也 有 两 个 用 来 获取 它 的 菜单 项 的 信息 的 get * 方 

法 。 GetMenuItemCount() 返回 菜单 中 项 目的 数量 ， GetMenuItems() 返回 菜单 
中 项 目的 一 个 列表 ， 项 目 在 列表 中 的 顺序 与 菜单 中 的 位 置 相 一 致 。 这 个 列表 是 菜 
中 实际 列表 的 一 个 拷贝 ， 意 味 着 改变 所 返回 的 列表 ， 不 会 改变 菜单 本 身 。 

对 于 有 效 的 菜单 ， 你 可 以 在 运行 时 继续 添加 或 删除 菜单 项 。 例 10.3 显 示 了 在 运行 时 
添加 菜单 的 示例 代码 。 当 按钮 被 按 下 时 ， 调 用 OnAddItem() 的 方法 来 插入 一 个 新 
的 项 到 菜单 的 尾部 。 


例 10.3 运行 时 添加 菜单 项 


import wx 


class MyFrame(wx.Frame): 


事件 


单项 


def 


def 


def 


def 


__ init__(self): 
wx.Frame.__init__(self, None, -1, 
"Add Menu Items") 
p = wx.Panel(self) 
self.txt - wx.TextCtrl(p, -1, "new item") 
btn - wx.Button(p, -1, "Add Menu Item") 
self.Bind(wx.EVT BUTTON, self.OnAddItem, btn)# RZ 


sizer = wx.BoxSizer(wx.HORIZONTAL ) 
sizer.Add(self.txt, ©, wx.ALL, 20) 
sizer.Add(btn, 0, wx.TOP|wx.RIGHT, 20) 
p.SetSizer(sizer) 


self.menu - menu - wx.Menu() 

simple - menu.Append(-1, "Simple menu item") 
menu.AppendSeparator() 

exit - menu.Append(-1, "Exit") 
self.Bind(wx.EVT MENU, self.OnSimple, simple) 
self.Bind(wx.EVT MENU, self.OnExit, exit) 


menuBar - wx.MenuBar() 
menuBar.Append(menu, "Menu") 
self.SetMenuBar(menuBar) 


OnSimple(self, event): 
wx.MessageBox("You selected the simple menu item") 


OnExit(self, event): 
self.Close() 


OnAddItem(self, event): 
item = self.menu.Append(-1, self.txt.GetValue())# 添加 菜 


self.Bind(wx.EVT MENU, self.OnNewItemSelected, item)# 7f 


定 一 个 菜单 事件 


if | name == "main ": 


def 


app 


OnNewItemSelected(self, event): 
wx.MessageBox("You selected a new item") 


- wx.PySimpleApp() 


frame = MyFrame() 
frame.Show() 


app 


.MainLoop() 


在 这 个 例子 中 ， OnAddItem() 人 并 使 用 Append() 来 添加 一 
个 新 的 项 到 菜单 中 。 另 外 ， 它 绑 定 了 一 人 菜单 事件 ， 以 便 这 个 新 的 菜单 项 有 相应 的 
功能 。 在 下 一 节 ， 我 们 将 讨论 菜单 事件 。 


如 何 响应 一 个 菜单 事件 ? 


在 最 后 这 一 小 节 : 我们 展示 两 个 响应 菜 单 选择 的 例子 代码 。 像 我 们 在 第 8 章 见 过 的 
许多 dudsa— 样 ， 选 择 一 个 菜单 项 将 触发 一 个 特定 类 型 的 wx.commandEvent 的 
一 个 实例 。 在 此 处 ， 该 类 型 是 wx.EVT_MENU ° 


菜单 项 事件 在 两 个 方面 与 系统 中 其 它 的 命令 事件 不 同 。 首 先 ， 用 于 关联 菜 oi 
ERRIMAK Bind() DATES US 上 的 。 第 二 ， 由 于 框架 通常 
有 多 个 与 wx.EVT_MENU 触发 相对 应 的 菜 项 ， 所 以 Bind() 方法 需要 第 三 A 
数 ， 它 就 是 菜单 项 本 身 。 这 使 得 框架 能 区 分 不 同 的 菜单 项 事件 。 


一 个 典型 的 绑 定 一 个 菜单 事件 的 调用 如 下 所 示 : 


self.Bind(wx.EVT MENU, self.OnExit, exit menu item) 


self 是 框架 ， self.OnExit 是 处 理 方法 ， exit menu item 是 菜单 项 自身 。 


尽管 通过 框架 绑 定 菜单 事件 的 主意 似乎 有 一 点 古怪 ， » 但 是 它 是 有 原因 的 。 通 过 框架 
绑 定 事件 使 你 能 够 透明 地 绑 定 一 个 工具 栏 按钮 到 与 菜单 项 相同 的 处 理 器 。 如 果 该 工 
具 栏 按钮 有 与 一 个 菜单 项 相同 的 wxPython ID 的 话 ， 那 么 这 个 单个 的 

对 wx.EVT MENU 的 Bind() 调用 将 同时 绑 定 该 菜 单 选择 和 该 工具 栏 按钮 敲 击 v dX 
是 可 行 的 ， 因 为 菜单 项 事件 与 工具 事件 都 经 由 该 框架 得 到 。 如 果菜 单项 事件 在 菜 
栏 中 被 处 理 ， 那 么 菜单 栏 将 不 会 看 到 工具 栏 事件 。 


At > AA S ARS -o 同一 个 处 理 器 。 例 如 ， 一 套 单 选 按钮 开关 菜 
单 〈《 它 们 本 质 上 作 相 同 的 事情 ) 可 能 被 绑 定 给 同一 处 理 器 。 如 果菜 单项 有 连续 的 标 
识 符号 的 话 ， 为 了 避免 分 别 的 一 一 绑 定 ， 可 以 使 用 wx.EVT_MENU_RANGE 事件 类 
型 : 


self.Bind(wx.EVT MENU RANGE, function, id=menu1, id2=menu2) 


在 这 种 情况 下 ， 所 有 标识 号 位 于 [ menui , menu2 JH ŽŽ os Ap DRE £126 x 05 H 
数 。 

尽管 通常 你 只 关心 菜单 项 命令 事件 ， ， 但 是 这 儿 有 你 能 够 响应 的 另外 的 菜单 事件 。 

在 wxPython 中 ， 类 wx.MenuEvent 管理 菜单 的 绘制 和 高 亮 事 件 。 表 10.3 说 明 

了 wx.MenuEvent 的 四 个 事件 类 型 。 


表 10.3 wx.MenuEvent 的 事件 类 型 


EVT_MENU_CLOSE 当 一 个 菜单 被 关闭 时 触发 。 


当 一 个 菜单 项 高 亮 时 触发 。 m anm 
EVT MENU HIGHLIGHT 菜单 项 的 ID 。 默 认 情 况 下 这 将 导致 帮助 文本 
被 显示 在 框架 的 状态 栏 中 。 


当 一 个 菜单 项 高 之 时 触发 ， 
特定 的 菜单 项 的 ID 意味 对 于 整个 菜单 

EVT MENU HIGHLIGHT ALL ” 栏 只 有 一 个 处 理 alee 望 任何 菜单 的 高 
亮 都 触发 一 个 动作 ， pr MR 单项 被 
选择 的 话 ， 你 可 以 调用 这 


EVT_MENU_OPEN 当 一 个 菜单 被 打开 时 触发 。 





现在 我 们 已 经 讨论 了 创建 菜单 的 基础 知识 ， 我 们 将 开始 说 明 如 何 使 用 菜单 项 来 工 
作 。 


使 用 菜单 项 工作 


尽管 菜单 和 菜 单 栏 对 于 一 个 菜 单 系统 很 明显 是 至 关 重 要 的 ， 但 是 是 你 的 大 部 分 时 间 和 
工作 将 化 在 处 理 菜 项 上 。 在 下 面 的 几 节 中 ， 我 们 将 谈论 通常 的 菜单 项 函数 ， 如 查 
找 一 个 项 目 ， 使 一 个 菜单 项 有 效 或 无 效 ， 创 建 开关 菜单 项 和 分 配 快捷 键 。 


如 何在 一 个 菜单 中 找到 一 个 特定 的 菜单 项 ? 


在 wxPython 中 有 许多 方法 用 于 查找 一 个 特定 的 菜单 或 给 定 了 标签 或 标识 符 的 

项 。 你 经 常 在 事件 处 理 器 中 使 用 这 些 方法 ， 尤 其 是 当 你 想 修 改 一 个 PIREA 
个 位 置 显示 它 的 标签 文本 时 。 * 例 10.1 对 先前 的 动态 菜 单 例子 作 了 补充 ， 它 通 过 使 
用 FindItemById() 得 到 菜单 项 以 显示 。 


例 10.4 发 现 一 个 特定 的 菜单 项 


import wx 


class MyFrame(wx.Frame): 

def _ init (self): 

wx.Frame.__init__(self, None, -1, 

"Find Item Example") 

p = wx.Panel(self) 

self.txt - wx.TextCtrl(p, -1, "new item") 

btn - wx.Button(p, -1, "Add Menu Item") 
self.Bind(wx.EVT BUTTON, self.OnAddItem, btn) 


sizer = wx.BoxSizer(wx.HORIZONTAL ) 
sizer.Add(self.txt, ©, wx.ALL, 20) 
sizer.Add(btn, 0, wx.TOP|wx.RIGHT, 20) 
p.SetSizer(sizer ) 


self.menu = menu = wx.Menu() 

simple = menu.Append(-1, "Simple menu item") 
menu.AppendSeparator() 

exit - menu.Append(-1, "Exit") 
self.Bind(wx.EVT MENU, self.OnSimple, simple) 
self.Bind(wx.EVT MENU, self.OnExit, exit) 


menuBar = wx.MenuBar() 
menuBar.Append(menu, "Menu") 
self.SetMenuBar(menuBar) 


def OnSimple(self, event): 
wx.MessageBox("You selected the simple menu item") 


def OnExit(self, event): 
self.Close() 


def OnAddItem(self, event): 
item - self.menu.Append(-1, self.txt.GetValue()) 
self.Bind(wx.EVT MENU, self.OnNewItemSelected, item) 


def OnNewItemSelected(self, event): 
item = self.GetMenuBar().FindItemById(event.GetId()) 4&4 

到 菜单 项 
text = item.GetText() 
wx.MessageBox("You selected the '%s' item" % text) 
if name == "_ main ": 
app - wx.PySimpleApp() 
frame = MyFrame() 
frame.Show() 

app.MainLoop() 


在 这 个 例子 中 ， FindItemById() 被 用 来 得 到 一 个 菜单 项 的 标签 文本 以 便 显 示 。 


wx.MenuBar 和 wx.Menu XT &4X4 x 49 X 3 项 有 者 本 质 上 相同 的 方法 。 其 主要 
的 区 别 是 ， wx.MenuBar 的 方法 将 查找 整个 菜单 栏 上 的 菜单 项 ， 而 Pernt RE 
找 特定 的 菜单 。 大 多 数 情 况 下 > MUR wx.MenuBar 的 方法 ， 因 为 菜单 栏 容 易 
使 用 wx.Frame.GetMenuBar() 方法 来 访问 。 


要 从 一 个 菜单 栏 查 找 一 个 顶级 的 菜单 ， 使 用 菜单 栏 方法 FindMenu(title) 。 这 个 
方法 返回 相应 菜单 的 索引 或 常量 wx.NOT_FOUND 。 要 得 到 实际 的 菜单 ， 使 
用 GetMenu() 


def FindMenuInMenuBar(menuBar, title): 
pos = menuBar.FindMenu(title) 

if pos == wx.NOT_FOUND: 

return None 

return menuBar.GetMenu(pos) 


FindMenu 方法 的 title 参数 匹配 菜单 的 标题 (不 \ 管 菜单 的 标题 有 无 修饰 标签 
A) 。 例 如 ， 即 使 菜单 的 标题 是 ， FindMenu( " File ") 仍 将 匹配 该 菜 项 。 P 
单 类 中 的 所 有 基于 标签 字符 串 发 现 一 个 菜单 项 的 方法 都 有 这 个 功能 。 


表 10.4 指 出 了 _ wx.MenuBar 的 这 些 方法 ， 它 们 能 够 被 用 于 查找 或 处 理 一 个 特定 的 菜 
单项 o 


10.4 wx.MenuBar 的 菜单 项 处 理 方法 


FindMenuItem(menuString , itemString) 


FindItemById(id) 


GetHelpString(id) , SetHelpString(id , helpString) 


GetLabel(id) , SetLabel(id , label) 


在 一 个 名 

为 menuString 
单 中 查找 名 

为 itemString 
单项 。 返 回 找到 
单项 

或 wx.NOT. FOU 


返回 与 给 定 
的 wxPython X 
相关 联 的 菜单 项 
RAA’ A 
回 None ° 


AT# id 的 
IR 85 d BAF RE P 
RAK ES o de 
这 样 的 菜单 项 ， 
么 get 方法 返 
回 ， set Jù 
作用 。 


用 于 给 定 id 的 
项 的 标签 的 获取 
置 。 如 果 没 有 这 
REM > AP 

A get Z ikiR 
puc ota o 
作用 。 这 些 方法 
用 在 菜单 栏 已 附 


一 个 框架 后 。 


表 10.5 显示 了 用 于 wx.Menu 的 菜单 项 处 理 方 法 。 它 们 分 别 与 菜单 栏 中 的 方法 相 类 


似 ， 除 了 所 返回 的 菜单 项 必须 在 所 调用 的 菜单 实例 中 。 


在 菜单 项 返回 后 ， 你 可 能 想 做 些 有 用 的 事情 ， 如 使 该 菜单 项 有 效 或 无 效 。 在 下 一 


节 ， 我 们 将 讨论 使 用 菜单 项 有 效 或 无 效 。 
表 10.5 wx.Menu 的 菜单 项 方法 


FindItem(itemString) 


FindItemById(id) 


FindItemByPosition(pos) 
GetHelpString(id) , SetHelpString(id , helpString) 


GetLabel(id) , SetLabel(id , label) 


如 何 使 一 个 菜单 项 有 效 或 无 效 ? 


返回 与 给 定 

的 itemString 
的 菜单 项 

或 wx.NOT_FOU 


返回 与 给 定 
的 wxPython X 
相关 联 的 菜单 项 
RAA’ A 
回 None ° 


返回 菜单 中 给 定 
的 菜单 项 

与 菜单 栏 的 对 应 
相同 。 


与 菜单 栏 的 对 应 
相同 。 


类 似 于 其 它 的 窗口 部 件 ， 菜 单 和 菜单 项 也 可 以 有 有 效 或 无 效 状态 。 一 个 无 效 的 菜 
或 菜单 项 通常 显示 为 灰色 文本 ， 而 非 黑色 。 无 效 的 菜单 或 菜单 项 不 触发 高 亮 或 选择 


事件 ， 它 对 于 系统 来 说 是 不 可 见 的 。 


例 10.5 显 示 了 开关 菜单 项 的 有 效 状 态 的 示例 代码 ， 其 中 在 按钮 的 事件 处 理 器 中 使 用 


了 菜单 栏 的 IsEnabled() 和 Enable() 方法 。 
例 10.5 


import wx 


ID_SIMPLE = 


wx .NewId( ) 


class MyFrame(wx.Frame): 

def _ init (self): 

wx.Frame.__init__(self, None, -1, 

"Enable/Disable Menu Example") 

p = wx.Panel(self) 

self.btn - wx.Button(p, -1, "Disable Item", (20,20)) 
self.Bind(wx.EVT BUTTON, self.OnToggleItem, self.btn) 


menu - wx.Menu() 
menu.Append(ID SIMPLE, "Simple menu item") 
self.Bind(wx.EVT MENU, self.OnSimple, id-ID SIMPLE) 


menu.AppendSeparator() 
menu.Append(wx.ID EXIT, "Exit") 
self.Bind(wx.EVT MENU, self.OnExit, id-wx.ID EXIT) 


menuBar - wx.MenuBar() 
menuBar.Append(menu, "Menu") 
self.SetMenuBar(menuBar) 


def OnSimple(self, event): 
wx.MessageBox("You selected the simple menu item") 


def OnExit(self, event): 
self.Close() 


def OnToggleItem(self, event): 

menubar = self.GetMenuBar() 

enabled = menubar.IsEnabled(ID SIMPLE) 
menubar.Enable(ID SIMPLE, not enabled) 
self.btn.SetLabel( 


if | name == "_ qain ": 


(enabled and "Enable" o "Disable") + " Item") 


app - wx.PySimpleApp() 
frame - MyFrame() 


frame.Show() 


app.MainLoop() 


要 查看 或 改变 菜 
调用 


项 自身 或 菜单 栏 上 的 ， 或 特定 菜单 上 的 一 个 菜单 项 的 有 效 状态 ， 


wx.MenuItem.IsEnabled() ^ wx.MenuBar.IsEnabled(id) 或 wx.Menu.IsEné 


方法 。 菜 单 栏 和 菜 


在 且 有 效 ， 那 么 这 两 个 方法 都 返回 True ， 如 果 该 菜单 项 不 存在 或 无 效 ， 那 么 这 两 


单方 法 都 要 求 一 个 菜单 项 的 wxPython 标识 符 。 如 果 该 菜单 项 存 


个 方法 都 返回 False 。 唯 一 的 区 别 是 wx.Menu 的 方法 只 在 特定 的 菜 单 中 搜索 ， , 
而 菜单 栏 方法 搜索 整个 菜单 栏 。 wx.Menultem 方法 不 要 求 参 数 ， 它 返回 特定 菜 
项 的 状态 。 


要 改变 有 效 状 态 ， 使 用 wx.MenuBar.Enable(id , enable) , 
wx.Menu.Enable(id , enable) ,或 

wx.MenuItem.Enable(enable) ° enable 参数 是 布尔 值 。 如 果 为 True > HH 
菜单 项 有 效 ， 如 果 为 False ， 相 关 菜 单项 无 效 。 Enable() 方法 的 作用 域 

和 IsEnabled() 方法 相同 。 你 也 可 以 使 

用 wx. MenuBarEnableTop(pos , enable) 方法 来 让 整个 顶级 菜单 有 效 或 无 效 。 
在 这 里 ， pos 参数 是 菜单 栏 中 菜单 的 整数 位 置 ， SIATE 参数 是 个 布尔 值 。 


如 何 将 一 个 菜单 项 与 一 个 快捷 键 关 联 起 来 ? 


图 10.3 显 示 了 一 个 示例 菜单 。 注 意 该 莱 单 的 菜单 名 中 有 一 个 带 下 划 线 的 字符 ， 其 中 
的 标签 为 Accelerated 的 菜单 项 的 快捷 键 是 Ctrl -A。 
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Figure 10.3 
Menu items with keyboard shortcuts 


研究 表明 快捷 键 并 不 总 是 能 够 节省 时 间 。 但 是 它们 是 标准 的 界面 元 素 ， 并 且 你 的 用 
户 也 希望 它们 的 存在 。 例 10.6 显 示 了 给 菜单 项 添加 快捷 键 的 代码 。 


例 10.6 


import wx 


class MyFrame(wx.Frame): 
def _init_ (self): 
wx.Frame. init__(self, None, -1, 
"Accelerator Example") 

p = wx.Panel(self) 
menu - wx.Menu() 

simple - menu.Append(-1, "Simple item") # Creating 
a mnemonic 

accel = menu.Append(-1, " NtCtrl-A") # Creating an acc 
elerator 


menu.AppendSeparator ( ) 
exit = menu.Append(-1, "E ") 


self.Bind(wx.EVT MENU, self.OnSimple, simple) 
self.Bind(wx.EVT MENU, self.OnAccelerated, accel) 
self.Bind(wx.EVT MENU, self.OnExit, exit) 


menuBar - wx.MenuBar() 
menuBar.Append(menu, "  ") 
self.SetMenuBar(menuBar) 


acceltbl = wx.AcceleratorTable( [ #Using an accelerator 
table 
(wx.ACCEL CTRL, od('Q'), exit.GetId()) 


] ) 
self .SetAcceleratorTable(acceltbl) 


def OnSimple(self, event): 
wx.MessageBox("You selected the simple menu item") 


def OnAccelerated(self, event): 
wx.MessageBox("You selected the accelerated menu item") 


def OnExit(self, event): 
self .Close() 


if _name__ == "__main_": 
app = wx.PySimpleApp( ) 
frame = MyFrame() 
frame. Show() 
app .MainLoop( ) 


在 wxPython 中 有 两 种 快捷 键 ; mnemonics (84724) 和 accelerator (加 速 


器 ) 。 下 面 ， 我 们 将 讨论 这 两 种 的 区 别 。 
使 用 助 记 符 快 捷 方 式 


助 记 符 是 一 个 用 来 访问 菜单 项 的 单个 字符 ， 以 一 个 带 有 下 划 线 的 字母 表示 。 助 记 符 
可 以 通过 为 菜单 或 菜单 项 指定 显示 的 文本 来 创建 ， 并 在 你 想 用 来 作为 助 记 符 的 字符 
前 面 放置 一 个 & 符 号 ， 例 如 ,或 Ma 。 如 果 你 希望 在 你 的 菜单 文本 中 有 一 个 & 符 
号 ， 那 么 你 必须 输入 两 个 && 符 号 ， 例 如 && © 


助 记 符 是 作为 在 菜单 树 中 选择 的 一 个 备用 的 方法 。 它 仅 在 被 用 户 显 式 地 调用 时 被 激 
活 ; 在 微软 Windows 下 ， 通 过 按 下 alt 键 来 激活 它 。 一 旦 助 记 符 被 激活 ， 下 一 
步 按 下 顶级 菜单 的 助 记 符 来 打开 顶级 菜单 。 这 样 一 步 打开 菜单 ， 直 到 一 个 菜单 项 被 
选择 ， 此 时 一 个 菜单 事件 被 触发 。 助 记 符 在 菜单 中 必须 是 独一无二 的 ， 但 在 整个 菜 
单 栏 中 可 以 不 是 独一无二 。 通 常 菜单 文本 的 第 一 个 字符 被 用 作 助 记 符 。 如 果 你 有 多 
个 菜单 项 有 相同 的 开头 字母 ， 那 么 就 没有 特定 的 准则 来 决定 那个 字符 用 作 助 记 符 

(最 常用 的 选择 是 第 二 个 和 最 后 一 个 ， 这 要 看 哪个 更 合理 ) 。 菜 单 文本 清晰 的 含义 
比 有 一 个 好 的 助 记 符 更 重要 。 


使 用 加 速 器 快捷 方式 


在 wxPython 中 加 速 器 是 一 个 更 加 典型 的 键盘 快捷 方式 ， 它 意味 能 够 随时 调用 的 按 
键 组 合 ， 这 些 按键 组 合 直 接触 发 菜单 项 。 加 速 器 可 以 用 两 种 方法 创建 。 最 简单 的 方 
法 是 ， 在 菜单 或 菜单 项 的 显示 文本 中 包括 加 速 器 按键 组 合 ( 当 菜 单 或 菜单 项 被 添加 
到 其 父 中 时 ) 。 实 现 的 方法 是 ， 在 你 的 菜单 项 的 文本 后 放置 一 个 \t。 在 \t 之 后 定义 组 
合 键 。 组 合 键 的 第 一 部 分 是 一 个 或 多 个 Alt , Ctrl ,或 Shift ， 由 一 个 + 或 一 
个 -分 隔 ， 随 后 是 实际 的 加 速 器 按键 。 例 

如 : New "tctrl -n, SaveAs \ tetri - shift-s。 即 使 在 第 一 部 分 你 只 有 一 个 专用 
的 键 ， 你 仍 可 使 用 + 或 -来 将 该 部 分 与 实际 的 按键 分 隔 。 这 不 区 分 按键 组 合 的 大 小 
Bo 


实际 的 键 可 以 是 任何 数字 、 字 母 或 功能 键 (如 F1 ~ F12 ) ， 还 有 表 10.6 所 列 出 的 
专用 词 。 


wxPython 的 方法 在 通过 名 字 查 找 一 个 菜单 或 菜单 项 时 忽略 助 记 符 和 加 速 器 。 换 多 
话说 ， 对 menubar.FindMenuItem( " File "," SaveAs ") 的 调用 将 仍 匹 配 Save 
as 菜单 项 ， 即 使 菜单 项 的 显示 名 是 以 Save ‘tetrl - shift-s% AMAA © 


加 速 器 也 可 能 使 用 加 速 器 表 被 直接 创建 ， 加 速 器 表 是 类 wx.AccleratorTable 的 
一 个 实例 。 一 个 加 速 器 表 由 wx.AccelratorEntry 对 象 的 一 个 列表 组 

成 。 wx.AcceleratorTable 的 构造 函数 要 求 一 个 加 速 器 项 的 列表 ， 或 不 带 参 数 。 
在 例 10.6 中 ， 我 们 利用 了 wxPython 将 隐 式 使 用 参数 ( wx.ACCEL_CTRL , 

od( 'Q')> exit.GetId()) 调用 wx.AcceleratorEntry 构造 函数 的 事 

实 。 wx.AcceleratorEntry 的 构造 函数 如 下 : 


wx.AcceleratorEntry(flags , keyCode , cmd) 


flags 参数 是 一 个 使 用 了 一 个 或 多 个 下 列 常量 的 位 掩 码 : wx.ACCEL ALT , 
WX.ACCEL CTRL , wxACCEL_NORMAL ,或 wx.ACCEL_SHIFT 。 该 参数 表明 哪个 
控制 键 需要 被 按 下 来 触发 该 加 速 器 。 keycode 参数 代表 按 下 来 触发 加 速 器 的 常规 
键 ， 它 是 对 应 于 一 个 字符 的 ASCII 数字 ， 或 在 wxwidgets 文本 中 

的 Keycodes 下 的 一 个 专用 字符 。 cmd 参数 是 菜单 项 的 wxPython 标识 符 ， 该 菜 


单项 当 加 速 器 被 调用 时 触发 其 命令 事件 。 正 如 你 从 例 10.6 所 能 看 到 的 ， 使 用 这 种 方 
法 声明 一 个 加 速 器 ， 不 会 在 这 个 带 菜单 项 显示 名 的 菜单 上 列 出 组 合 键 。 你 仍 需 要 单 
RES 


10.6 非 字 母 顺 序 的 加 速 器 键 
加 速 器 BE 


delDelete deleteDelete downDown arrow  endEnd  enterEnter 
escEscape  escapeEscape  homeHome  insInsert  insertInsert 
leftLeft arrow  pgdnPage down  pgupPage Up  returnEnter 
rightRight arrow  spaceSpace bar  tabTab upUp arrow 


如 何 创 建 一 个 复 选 或 单 选 开关 菜单 项 ? 


菜单 项 不 仅 用 于 从 选择 表单 中 得 到 用 户 的 输入 ， 它 们 也 被 用 于 显示 应 用 程序 的 状 

态 。 经 由 菜单 项 来 显示 状 态 的 最 常用 的 机 制 是 开关 菜单 项 的 使 用 ， 开 关 菜 单项 仿效 
一 个 复 选 框 或 单 选 按钮 (你 只 能 够 通过 改变 该 菜 单项 的 文本 或 使 用 有 效 或 无 效 状态 
来 反映 应 用 程序 的 状态 ) 。 图 10.4 显 示 了 复 选 和 单 选 菜单 项 的 例子 。 
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Figure 10.4 Sample toggle menus, showing 
both checkboxes and radio button menu items 


顾名思义 ， 一 个 复 选 开关 菜单 项 在 它 每 次 被 选择 时 ， 它 在 开 和 关 状 态 间 转换 。 在 一 
个 组 中 ， 一 次 只 允许 一 个 单 选 菜单 项 处 于 开 的 状态 。 当 同一 组 中 的 另 一 个 菜单 项 被 
选择 时 ， 先 前 的 菜单 项 改变 为 关 状态 。 例 10.7 显示 了 如 何 创 建 复 选 和 单 选 菜单 项 。 


例 10.7 建造 开关 菜单 项 


import wx 


class MyFrame(wx.Frame): 
def _init_ (self): 
wx.Frame.__init__(self, None, -1, 
"Toggle Items Example") 

p = wx.Panel(self) 
menuBar - wx.MenuBar() 
menu - wx.Menu() 
exit - menu.Append(-1, "Exit") 
self.Bind(wx.EVT MENU, self.OnExit, exit) 
menuBar.Append(menu, "Menu") 


menu - wx.Menu() 
menu.AppendCheckItem(-1, "Check Item 1") 
menu.AppendCheckItem(-1, "Check Item 2") 
menu.AppendCheckItem(-1, "Check Item 3") 
menu.AppendSeparator ( ) 
menu.AppendRadioItem(-1, "Radio Item 1") 
menu.AppendRadioItem(-1, "Radio Item 2") 
menu.AppendRadioItem(-1, "Radio Item 3") 
menuBar.Append(menu, "Toggle Items") 


self.SetMenuBar(menuBar) 


def OnExit(self, event): 
self.Close() 


if name == " main ": 
app - wx.PySimpleApp() 
frame - MyFrame() 
frame.Show() 
app.MainLoop() 


正如 你 从 例子 所 见 到 的 ， 通 过 使 用 方法 AppendCheckItem(id , item , 
helpstring ="") 来 添加 一 个 复 选 框 菜 单项 ， 该 方法 类 似 于 Append() 。 该 方法 
的 参数 是 wxPython 标识 符 、 显 示 在 菜单 中 的 名 字 、 显 示 在 状态 栏 听 帮助 字符 

串 。 同 样 ， 你 可 以 使 用 PrependcheckItem(id , item , helpString ="") 

和 InsertCheckItem(pos , id , item , helpString =")， 这 两 个 方法 的 行为 
与 它们 的 无 复 选 框 的 版 本 相同 。 


单 选 按钮 菜单 项 可 以 使 用 AppendRadioItem(id , item , helpstring =") 方 法 
来 添加 ， 你 也 可 以 使 用 PrependRadioItem(id , item , helpString ="") 

和 InsertRadioItem(pos , id , item , helpString ="") 方法。 一 系列 连续 
的 单 选 菜单 项 被 作为 一 组 ， 一 组 中 一 次 只 能 有 一 个 成 员 被 触发 。 组 以 第 一 个 非 单 选 
菜单 项 或 菜单 分 隔 符 为 界 。 默 认 情 况 下 ， 当 单 选 组 被 创建 时 ， 该 组 中 的 第 一 个 成 员 
处 于 选中 状态 。 


开关 菜单 项 可 以 通过 使 用 Append() 来 创建 。 Append() 的 kind 参数 要 求 下 列 
常量 值 之 一 : wx.ITEM CHECK , wx.ITEM NORMAL , 

wx.ITEM RADIO 或 wx.ITEM SEPARATOR ， 其 中 的 每 个 值 创建 一 个 适当 类 型 的 菜 
单项 。 这 是 有 用 的 ， 如 果 你 正在 使 用 某 种 数据 驱动 过 程 自动 创建 这 些 菜单 项 的 话 。 
所 有 类 型 的 菜单 项 都 可 以 使 用 这 同 种 方法 来 创建 ， 尽 管 指 

Æ kind A wx.ITEM SEPARATOR 来 生成 一 个 分 隔 符 必 须 给 id 参数 传 

递 wx.ID SEPARATOR 。 


当 你 使 用 wx.MenuItem a 项 (给 参 
数 kind 一 个 相应 的 常量 值 ) 。 所 得 的 菜单 项 可 以 使 用 Se uen) ， 
PrependItem() , InsertItem() LiF RRA oS 一 个 菜单 。 


要 确定 一 个 菜单 项 的 开关 状态 ， 使 用 Ischeckable() ， 如 果 该 项 是 一 个 复 选 或 单 
选项 ， 函 数 返 回 True ， 使 用 IsChecked() ， 如 果 该 项 是 可 开关 的 且 处 于 选中 
KA? MARA True 。 你 也 可 以 使 用 Check(check) 方法 来 设置 一 个 菜单 项 的 
开关 状态 ， check 是 一 个 布尔 参数 。 使 用 Check(check) 方法 设置 时 ， 被 设置 的 
菜单 项 是 单 选 的 ， 那 么 将 影响 同一 组 别 的 项 。 


你 也 可 以 使 用 IsChecked(id) 从 菜单 或 菜单 栏 得 到 一 个 菜单 项 的 开关 状态 ， 它 要 
求 相应 菜单 项 的 id 。 你 也 可 以 使 用 Check(id ，check) 来 设置 菜单 栏 或 菜单 
中 的 菜单 项 ， 参 数 check 是 布尔 值 。 


步 构建 菜 
在 接 下 来 的 几 节 ， 我 们 将 通过 使 你 的 菜单 更 杂 化 来 让 它 更 有 用 。 o KARMAI OE 
套 的 子 菜单 ， 然 后 是 在 你 的 程序 中 加 入 弹出 菜单 。 最 后 是 构建 总 爱 样式 的 菜单 项 。 


如 何 创建 一 个 子 菜单 ? 


如 果 你 的 应 用 程序 变 得 太 复 杂 ， 你 可 以 在 顶级 菜单 中 创建 子 菜单 ， 这 使 你 能 够 在 一 
个 项 级 菜 BP ER 单项 且 装 入 更 多 的 项 目 。 对 于 将 一 系列 的 属于 同一 逻辑 的 选项 
组 成 一 组 ， 子 菜单 是 十 分 有 用 的 ， 尤 其 是 要 将 太 多 的 选项 地 放 入 顶级 菜单 的 时 候 。 
图 10.5 显 示 了 一 个 使 用 子 菜单 的 示例 。 


图 10.5 
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Figure 10.5 A submenu in wxPython 


例 10.8 显 示 了 产生 图 10.5 的 代码 。 
例 10.8 建造 一 个 谋 套 的 子 菜 3 


import wx 


class MyFrame(wx.Frame): 
def _ init (self): 
wx.Frame.__init__(self, None, -1, 
"Sub-menu Example") 
p = wx.Panel(self) 
menu - wx.Menu() 


submenu - wx.Menu() 

submenu.Append(-1, "Sub-item 1") 
submenu.Append(-1, "Sub-item 2") 
menu.AppendMenu(-1, "Sub-menu", submenu)zZJZe-f X 3X 


menu.AppendSeparator() 
exit - menu.Append(-1, "Exit") 
self.Bind(wx.EVT MENU, self.OnExit, exit) 


menuBar = wx.MenuBar() 
menuBar.Append(menu, "Menu") 
self.SetMenuBar (menuBar ) 


def OnExit(self, event): 
self.Close() 


if name == " main ": 
app - wx.PySimpleApp() 
frame - MyFrame() 
frame.Show() 
app.MainLoop() 


你 从 例 10.8 会 注意 到 ， 子 菜单 的 创 单 的 相同 。 你 创建 
类 wx.Menu 的 一 2o ， 然 后 以 相同 的 方法 给 子 菜 单 增 加 菜单 项 。 不 同 的 是 子 菜 


单 没有 被 添加 到 顶级 菜单 栏 ， 而 是 使 用 me | 


e text , submenu , helpStr) 把 它 添加 给 个 菜单 。 该 函数 的 参数 类 似 


于 Append() 的 。 参 数 id 是 要 添加 到 的 菜 标识 符 。 参 

Jk text 是 子 菜单 显示 在 父 菜单 中 的 字符 串 。 参 数 submenu 是 子 菜单 自 
身 ，helpStr 是 显示 在 状态 栏 中 的 文本 。 另 外 还 有 子 菜单 的 插入 方 

法 : PrependMenu(id , text , submenu , 

helpStr) 和 InsertMenu(pos , text , submenu , helpStr) 。 这 些 方 
法 的 行为 与 这 章 前 面 我 们 所 讨论 的 菜单 项 的 播 入 方法 的 行为 类 似 。 


> 子 菜单 创建 又 的 顺序 相对 于 单纯 的 菜 单项 来 说 是 较为 重要 的 ， ， 我 们 推荐 


你 先 将 项 目 添加 给 ud ， 然 后 将 子 菜单 附加 给 父 菜单 。 、 wxPython 能 够 正 


ae 


ARP EM RE S TARET RESERRE C 通过 给 已 有 的 子 菜单 添 


加 子 菜单 来 实现 ， 而 非 将 子 菜单 添加 到 顶级 菜单 ， 在 添加 新 的 子 菜 单 之 前 ， 你 仍 需 
要 创建 创建 它 。 


如 何 创 建 弹出 式 菜单 ? 


菜单 不 仅 能 够 从 框架 顶部 的 菜单 栏 向 下 拉 ， 而 且 它 们 也 可 以 在 框架 的 任 一 处 弹出 。 
多 数 情况 下 ， 一 个 弹出 菜单 用 于 根据 上 下 文 和 用 户 所 敲 击 位 置 的 对 象 来 提供 相应 的 
行为 。 图 10.6 显 示 了 一 个 弹出 式 菜单 的 例子 。 


图 10.6 
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Figure 10.6 Apop-up menu being popped up 


弹出 菜单 的 创建 是 非常 类 似 于 标准 菜单 的 ， 但 是 它们 不 附加 到 菜单 栏 。 例 10.9 显 示 
了 一 个 弹出 菜单 的 示例 代码 。 


例 10.9 在 任意 一 个 窗口 部 件 中 创建 一 个 弹出 式 菜 


import wx 


class MyFrame(wx.Frame): 
def _init_ (self): 
wx.Frame.__init__(self, None, -1, 
"Popup Menu Example") 
self.panel = p = wx.Panel(self) 
menu = wx.Menu() 
exit = menu.Append(-1, "Exit") 
self.Bind(wx.EVT MENU, self.OnExit, exit) 


menuBar = wx.MenuBar() 
menuBar.Append(menu, "Menu") 
self.SetMenuBar(menuBar) 


wx.StaticText(p, -1, 
"Right-click on the panel to show a popup menu", 
(25,25)) 


self.popupmenu = wx.Menu( )# 创 建 一 个 菜单 

for text in "one two three four five".split():##2A%3 
item = self.popupmenu.Append(-1, text) 
self.Bind(wx.EVT MENU, self.OnPopupItemSelected, ite 


p.Bind(wx.EVT CONTEXT MENU, self.OnShowPopup)ZZR3x —^- È 7T 


def OnShowPopup(self, event) :#3# H Xm 
pos - event.GetPosition() 
pos - self.panel.ScreenToClient(pos) 
self.panel.PopupMenu(self.popupmenu, pos) 


def OnPopupItemSelected(self, event): 
item = self.popupmenu.FindItemById(event.GetId()) 
text - item.GetText() 
wx.MessageBox("You selected item '%s'" % text) 


def OnExit(self, event): 
self .Close() 
if name == "_ main_": 
app = wx.PySimpleApp( ) 
frame = MyFrame() 
frame. Show( ) 
app .MainLoop() 


弹出 菜单 像 任 一 其 它 菜 单一 样 被 创建 (注意 for 循环 对 于 快速 创建 菜单 项 的 用 
法 ) 。 它 没有 被 添加 到 菜单 栏 ， 它 被 存储 在 实例 变量 self.popupmenu 中 。 然 
后 ， 框 架 将 方法 OnShowPopup() 绑 定 到 事件 wx.EVT_CONTEXT_MENU 。 该 事件 被 


操作 系统 的 触发 弹出 菜单 的 标准 机 制 所 触发 。 在 微软 Windows 和 GTK F > 3^ 
PU A Rea ea? d£ Mac OS 下 ， 它 是 一 个 control MH ° 


38 P dEAEIR E dU ANE h kR A AYN 4K > ZILA OnShowPopup() 被 调用 。 
该 方法 所 做 的 第 一 件 事 是 确定 显示 菜单 的 位 置 。 传 递 给 该 方法 的 事件 的 位 置 

(在 wx.EVT_CONTEXT_MENU 的 实例 中 ) 是 以 屏幕 的 绝对 坐标 存储 的 ， 所 以 我 们 需 
要 将 位 置 坐 标 转换 为 相对 于 包含 弹出 菜单 的 面板 的 坐标 ， 我 们 使 用 方 

法 ScreenToClient() ° 


此 后 ， 使 用 方法 PopupMenu(menu , pos) 调用 弹出 菜 ”你 也 可 以 使 用 相关 的 方 
法 PopupMenuXY(menu ,X, y) ° PopupMenu 元 数 不 返 回 ， 直 到 一 个 菜单 项 被 选 
择 或 通过 按 下 Esc 或 在 该 弹出 菜 SB Jp a EAR ASE UR 单 消失 。 如 果 一 个 菜单 项 
被 选择 ， 那 么 它 的 事件 被 正常 处 理 (这 意味 它 必 须 有 一 个 方法 与 事件 EVT_MENU BF 
定 ) ， 并 且 在 PopupMenu 方法 返 回 前 该 事件 也 被 完成 。 PopupMenu 的 返回 值 是 
布尔 值 ， 没 什么 意思 。 

弹出 菜单 可 以 有 一 个 标题 ， 当 弹出 菜单 被 激活 时 它 显 示 在 弹出 菜单 的 顶部 。 这 个 标 
题 使 用 属性 wx.Menu.SetTitle(title) 和 wx.Menu.GetTitle() 来 处 理 。 


如 何 创 建 自己 个 性 的 菜单 ? 


如 果 普 通 的 菜单 项 引 不 起 你 足够 的 兴趣 ， 你 可 以 添加 自 定义 的 位 图 到 菜单 项 的 汶 边 
(或 用 作 自 定义 的 检查 符号 ) 。 在 微软 Windows 下 ， 你 也 可 以 调整 菜单 项 的 字体 
和 颜色 。 图 10.7 显 示 了 一 个 个 性 菜单 的 例子 。 


图 10.7 
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Figure 10.7 Menu items with custom 
bitmaps, colors, and fonts 


410. 103. T P RAR 单 的 代码 。 要 确定 程序 是 否 运行 在 Windows 下 ， 你 可 以 
检查 ' wxMSW ' 是 否 在 wx.PlatformInfo Bua 


1510.10 个 性 菜单 项 的 示例 代码 


import wx 


class MyFrame(wx.Frame): 
def _init_ (self): 
wx.Frame. init__(self, None, -1, 
"Fancier Menu Example") 
p = wx.Panel(self) 
menu = wx.Menu() 


bmp = wx.Bitmap("open.png", wx.BITMAP TYPE PNG) 
item - wx.MenuItem(menu, -1, "Has Open Bitmap") 
item.SetBitmap(bmp )# 增 加 一 个 自 定义 的 位 图 
menu.AppendItem(item) 


if True o 'wxMSW' in wx.PlatformInfo: 
font - wx.SystemSettings.GetFont( 
wX.SYS DEFAULT GUI FONT) 
font .SetWeight (wx.BOLD) 
item = wx. MenuItem(menu, -1, "Has Bold Font") 
item.SetFont(font)Z7 X FIA 
menu.AppendItem(item) 


item = wx.MenuItem(menu, -1, "Has Red Text") 
item.SetTextColour("red" )#X ELAR E 
menu.AppendItem(item) 


menu.AppendSeparator() 
exit - menu.Append(-1, "Exit") 
self.Bind(wx.EVT MENU, self.OnExit, exit) 


menuBar = wx.MenuBar() 
menuBar.Append(menu, "Menu") 
self.SetMenuBar (menuBar ) 


def OnExit(self, event): 
self.Close() 


if name == " main ": 
app - wx.PySimpleApp() 
frame - MyFrame() 
frame.Show() 
app.MainLoop() 


处 理 控 制 显 示 属 性 的 主要 的 内 容 是 给 一 个 菜单 项 添加 颜色 或 样式 。 适 合 除 
了 windows 外 (包括 windows) 的 平台 的 唯一 的 属性 是 bitmap * 
由 GetBitmap() 管理 ， 该 函数 返回 一 个 wx.Bitmap 类 型 的 项 。 这 儿 有 两 


个 set * 方 法 。 第 一 个 是 SetBitmap(bmp) ， 它 工作 于 所 有 的 平台 上 。 pou 


KEM dr dd B —4M ERE o WRIRLERR windows E> HARM 
个 开关 菜单 设置 一 个 自 定 义 的 位 图 ， 你 可 以 使 用 SetBitmaps(checked , 


unchecked = wx.NullBitmap) ， 它 使 得 当 该 项 被 选中 时 显示 一 个 位 图 ， 该 项 未 
选中 时 显示 另 一 个 位 图 。 如 果 该 菜单 项 不 是 一 个 开关 菜单 项 ， 那 么 checked 参数 
是 没有 用 的 。 


在 微软 Windws 下 ， 有 三 个 另外 的 属性 ， 你 可 以 用 来 改变 菜单 项 的 外 观 ， 如 表 10.7 
所 示 。 我 们 建议 你 谨 惯 地 使 用 它们 ， 并 且 仅 在 它们 能 够 明显 地 增强 用 户 的 体验 的 情 
况 下 。 


表 10.7 菜单 项 的 外 观 属性 


属性 类 型 是 wx,Colour ， 该 set *F 
GetBackgroundColour() 法 的 参数 也 可 以 是 一 个 wxPython mH & 
的 名 称 字符 串 。 管 理 项 目的 背景 色 。 


SetBackgroundColour(colour) 
GetFont() 项 目的 显示 字体 。 类 型 是 wx.Font ° 
SetFont(font ) 


管理 显示 在 项 目 中 的 文本 的 颜色 。 类 型 


GetTextColour 
2 和 背景 色 的 相同 。 


SetTextColour (colour ) 


目前 我 们 已 经 讨论 了 使 用 菜单 功能 方面 的 内 容 ， 接 下 来 我 们 将 对 如 何 更 好 的 使 用 菜 
单 以 及 如 何 使 你 的 应 用 程序 对 用 户 来 说 更 容 多 使 用 的 问题 作 一 个 纲要 性 的 说 明 ， 以 
结束 本 章 。 


菜单 设计 的 适用 性 准则 

对 于 大 多 数 复 杂 的 应 用 程序 ， 菜 单 栏 是 用 户 访 问 应 用 程序 功能 的 主要 入 口 。 正 确 的 
设计 菜单 对 你 的 程序 的 易 用 性 有 很 大 的 帮助 。 本 着 这 一 想法 ， 我 们 提供 了 一 些 关于 
菜单 设计 的 适用 性 准则 。 

使 菜单 有 均衡 的 长 度 

建议 菜单 所 包含 的 项 目的 最 大 数量 在 10 到 15 之 间 。 超 过 这 个 最 大 长 度 的 菜单 将 会 看 
不 全 。 你 应 该 学 习 创 建 长 度 基本 一 致 的 菜单 ， 记 住 ， 这 有 时 是 不 可 能 或 不 必要 的 。 
创建 合理 的 项 目 组 

你 不 应 该 创建 一 个 没有 分 隔 符 的 多 于 五 个 项 目的 组 ， 除 非 你 有 非常 合理 的 理由 这 样 
做 如 一 个 历史 列表 ， 或 一 个 插件 列表 。 多 于 五 个 项 目的 组 ， 用 户 处 理 起 来 非常 
困难 。 要 有 一 个 更 大 的 组 ， 项 目 需要 被 强 有 力 地 联系 在 一 起 并 且 要 有 用 户 期 望 长 于 
五 个 项 目的 列表 的 原因 。 

菜单 的 顺序 要 遵循 标准 





对 于 菜单 的 顺序 ， 你 应 该 遵循 公认 的 标准 。 最 左边 的 菜单 应 该 是 FILE (文件 ) ， 
并 且 它 包含 new (新 建 ) » open (打开 ) > save (保存 ) > print ( 打 
ep) fe quit (退出 ) 功能 ， 所 包含 的 功能 的 顺 也 是 这 样 ， 另 外 的 一 些 功 能 通常 添 
加 在 打印 和 退出 之 间 。 几 乎 每 个 应 用 程序 都 要 使 用 到 这 些 功能 。 下 一 个 菜单 

是 EDIT (编辑 ) ， 它 包含 undo (撤消 ) > cut (Bw) > copy (# 

JW) > paste (粘贴 ) 和 常用 的 find (ER) ， 这 些 依赖 于 你 的 程序 的 应 用 范 
。 HELP (4535) 菜单 总 是 在 最 右边 ， 并 且 windows (窗口 ) 菜单 经 常 是 挨 着 
它 的 。 中 间 的 其 它 菜单 通常 由 你 自己 来 决定 。 


对 通常 使 用 的 项 目 提供 方便 的 访问 


用 户 总 是 会 更 先 访问 到 菜单 中 更 上 面 的 项 目 。 这 就 说 明了 更 常用 的 选项 应 放 在 顶 
部 。 有 一 个 例外 就 是 多 数 研 究 显示 ， 第 二 项 先 于 第 一 项 。 

使 用 有 含义 的 菜单 名 称 

记 住 ， 位 于 菜单 栏 上 的 菜单 的 宽度 是 与 它 的 名 称 成 正比 的 ， 并 且 当 菜单 打开 时 它 的 
宽度 与 它 所 包含 的 项 目的 最 长 的 名 字 成 正比 。 尽 量 避 免 使 顶级 菜单 的 名 字 少 于 四 个 
字母 。 除 了 通常 的 名 称 外 ， 我 们 建议 只 要 有 可 能 ， 名 字 再 长 点 ， 但 意义 要 清楚 。 不 
要 害怕 给 一 个 菜单 项 较 长 的 文本 ， 尽 管 30~40 个 字符 可 能 难 读 。 

当 一 个 项 目 会 调用 一 个 对 话 框 时 ， 记 住 带 有 省 略 号 

任何 会 导致 一 个 对 话 框 被 显示 的 菜单 项 ， 都 应 该 有 一 个 以 省 略 号 (...) 结尾 的 标 


使 用 标准 的 快捷 键 
对 快捷 键 ， 使 用 通常 功能 的 公认 的 标准 ， 如 表 10.8 所 示 。 


表 10.8 快捷 键 功能 


Ctrl -a 全 选 


Ctrl -c 拷贝 
Ctrl -f 查找 
Ctrl -g 区 了 下 二 外 
Ctrl -n 新 建 
Ctrl -o 4] FF 
Ctrl -p 打印 
Ctrl -q 退出 
Ctrl -s 保存 
Ctrl -V 粘贴 
Ctrl -w 关闭 
Ctrl -x 剪 切 
Ctrl -z 撤消 


这 里 没有 列 出 Redo (Sth) 的 公认 的 快捷 键 ， 你 有 时 会 看 到 用 于 它 的 Ctrl - 
y' Alt -Z 或 其 它 的 组 合 。 如 果 你 给 通常 功能 提供 了 更 多 的 快捷 键 ， 那 么 建议 你 给 
人 * d 变 它们 。 快 捷 键 在 用 户 做 大 量 的 输入 工作 时 是 很 有 用 的 ， 例 
如 一 个 文本 编辑 器 。 但 是 对 于 大 部 分 用 鼠标 完成 的 工作 ， 它 们 的 作用 就 很 少 了 。 


反映 出 开关 状态 


当 创 建 一 个 开关 菜单 时 ， 有 两 个 事情 注意 。 第 一 ， 记 住 ， 一 个 未 选 中 的 复 选 
XO RB E ° o 、 项 的 文本 如 fancy mode 

on 的 话 ， 那么 用 户 就 有 可 能 不 知道 选择 这 个 菜单 项 会 改变 样式 。 另 一 个 要 注意 的 
是 ， x3 项 文本 要 反映 出 当 前 不 是 被 激活 的 状态 ， 而 非 激 活 状态 o 比如 菜 菜单 文本 说 
明 如 果 选 择 它 会 执行 什么 动作 。 例 如 ， 如 果 fancy 样式 是 打开 的 ， 那 么 文本 使 

用 Turn fancy mode off 。 菜 单 中 没有 语句 表明 fancy 样式 实际 是 什么 样 
的 ， 这 可 以 引起 混淆 。 要 避免 这 个 问题 ， 对 于 一 个 未 被 选择 的 菜单 ， 使 用 一 个 自 定 
义 的 位 图 以 视觉 的 方式 说 明 这 个 菜单 是 一 个 开关 菜单 ， 是 一 个 好 的 主意 (平台 允许 
的 话 ) 。 如 果 你 的 平台 不 支 的 话 ， ' 使 用 像 toggle fancy mode 或 switch 
fancy mode ( now on) 这 样 的 文本 意思 会 更 清楚 。 


HE Wk RE 
REBRY REM TW RTA AB © 
避免 使 用 字体 和 颜色 


你 记得 有 哪 一 个 应 用 程序 在 它 的 菜单 项 中 使 用 了 字体 和 颜色 的 。 我 们 也 不 这 要 使 用 
(但 是 用 于 选 先 择 字体 或 凑 色 的 菜单 是 例外 ) 。 很 明显 ， 这 种 使 用 非常 少见 。 


本 章 小 结 


.在 图 形 用 户 界面 中 ， 菜 单 是 最 常用 来 让 用 户 触发 命令 的 机 制 。 在 wxPython 中 ， 
建 菜单 使 用 三 个 主要 的 类 : wx.MenuBar ， 它 表示 菜单 栏 并 包含 菜单 ， 菜 单 使 
wx.Menu ° 菜单 由 菜 单项 组 成 ， 菜 单项 使 用 wx.MenuItem 。 对 于 菜单 部 分 的 
JÆ > 首先 创 | 建 菜 HOHER TE 。 然 后 分 别 创 | 建 个 个 菜单 ， 并 添加 菜单 
o FLAG 3 菜单 添加 到 站 菜单 栏 o 菜 项 可 以 被 派 加 到 菜单 的 任意 位 置 o 一 个 菜单 项 也 
可 以 是 一 个 菜单 分 隔 符 ， 而 非 普通 的 菜 项 。 当 菜单 项 被 添加 到 其 父 菜单 时 ， 菜 单 

项 对 象 可 以 被 显 式 地 或 隐 含 地 创建 


GEN CE CINE wx.EVT. MENU. XA A SH o RB EH B IER 
定 ， 而 非 菜单 项 ， 菜 单 或 菜单 栏 "这 让 工具 栏 按钮 可 以 触发 与 一 个 菜单 项 相同 

的 wx.EVT MENU 事件 。 如 果 你 有 多 个 有 着 连续 标识 符 的 菜单 项 ， 它 们 有 相同 的 处 
理 器 的 话 ， 那 么 它们 可 以 使 用 wx.EVT MENU RANGE 事件 类 型 被 绑 定 在 一 起 调用 。 


项 能 够 从 包含 它们 的 菜单 或 菜单 栏 使 用 ID 或 标签 来 查找 。 也 可 以 被 设置 成 
有 效 或 无 效 。 


一 个 菜单 可 以 被 附加 给 另 一 个 菜单 ， 而 非 菜 单 栏 ， 从 而 形成 一 个 瞪 套 的 子 菜 
单 。 wx.Menu 有 特定 的 方法 使 你 能 够 添加 子 菜单 ， 同 样 也 能 够 添加 一 个 菜单 项 。 


菜单 可 以 用 两 种 方法 与 按键 关联 。 助 记 符 和 加 速 器 。 


aa 菜单 项 可 以 有 一 个 开关 状态 o E E 单项 ， 也 可 以 是 一 个 单 选 菜 
单项 。 菜 单项 的 选择 状态 可 以 经 由 它 的 菜单 或 菜单 来 查询 或 改变 。 


.可 以 创建 弹出 式 菜单 。 这 通过 捕获 wx.EVT CONTEXT. MENU REF > 并 使 

用 PopupMenu() 方法 来 显示 弹出 。 在 弹出 中 的 菜单 项 事件 被 正常 地 处 理 。 
你 可 以 为 一 个 菜单 项 创建 一 个 自 定义 的 位 图 ， 并 且 在 Windows 操作 系统 下 ， 你 可 
以 改变 一 个 菜单 项 的 颜色 和 字体 。 


第 十 一 章 使 用 Sizer 放 置 构件 


1. 使 用 sizer 放 置 窗口 oo 
i sizerzc 1t A 
i. VE OHRME grid 
i 什么 是 grid 
ji， 如 何 对 Sizer 添 加 或 移 除 孩子 ? 
iii，sizer 是 如 何 管理 它 的 孩子 的 尺寸 和 对 齐 的 ? 
iv. 能够 为 Sizer 或 它 的 孩子 指定 一 个 最 小 的 尺寸 吗 ? 
V. Sizer 如 何 管理 每 个 孩子 的 边框 ? 
iii， 使 用 其 它 类 型 的 Sizer 
i， 什 么 是 flex grid sizer ? 
ii 什么 是 grid bag sizer? 
iii. 1T 4 Xbox 
iv. 4t A X static 
iv. 一 个 现实 中 使 用 sizer 的 例子 
v. 本 章 小 结 


本 章 内 容 

.理解 sizer 

.使 用 sizer 分 隔 窗口 部 件 
.使 用 sizer 的 grid 系列 
.使 用 box sizer 

.看 看 sizer 的 实际 应 用 


传统 上 ， 在 用 户 界面 编程 中 的 最 苦恼 的 一 个 问题 是 管理 窗口 中 的 窗口 部 件 的 实际 布 
局 。 因 为 它 涉及 到 与 绝对 位 置 直接 打 交 到 ， 这 是 很 痛苦 的 一 件 事 情 。 


所 以 你 需要 一 个 结构 ， 它 根据 预 设 的 模式 来 决定 如 何 调整 和 移动 窗口 部 件 。 目 前 推 
荐 用 来 处 理 复 杂 布 局 的 方法 是 使 用 sizer 。 sizer 是 用 于 自动 布局 一 组 窗口 部 
件 的 算法 。 sizer 被 附加 到 一 个 容器 ， 通 常 是 一 个 框架 或 面板 。 在 父 容 器 中 创建 
的 子 窗口 部 件 必 须 被 分 别 地 添加 到 sizer 。 当 sizer 被 附加 到 容器 时 ， 它 随后 
就 管理 它 所 包含 的 孩子 的 布局 。 


使 用 sizer 的 好 处 是 很 多 的 。 当 子 窗口 部 件 的 容器 的 尺寸 改变 时 ， sizer 将 自 
动 计 算 它 的 孩子 的 布局 并 作出 相应 的 调整 。 同 样 ， 如 果 其 中 的 一 个 孩子 改变 了 尺 
d 982A sizer 能 够 自动 地 刷新 布局 。 此 外 ， 当 你 想 要 改变 布局 时 ， sizer 管 
理 起 来 很 容易 。 最 大 的 葬 端 是 sizer 的 布局 有 一 些 局 限 性 。 但 是 ， 最 灵 
活 sizer grid bag 和 box ， 能 够 做 你 要 它们 做 的 几乎 任何 事 。 





sizerz 1t A ? 


一 个 wxPython sizer 是 一 个 对 象 ， 它 唯一 的 目的 就 是 管理 容器 中 的 窗口 部 件 的 
布局 。 sizer 本 身 不 是 一 个 容器 或 一 个 窗口 部 件 。 P 
所 有 的 sizer 都 是 抽象 类 wx.Sizer 的 一 个 子 类 的 实例 。 wxPython 提供 

个 sizer ， 定 义 在 表 11.1 中 。 sizer 可 以 被 放置 到 别 的 sizer 中 以 达 ae 
的 管理 。 


表 11.1 wxPython 中 预定 义 的 sizer 


cii eae” 当 你 要 放置 的 窗口 部 件 都 是 同样 的 尺寸 且 整 齐 
地 放 入 一 个 规则 的 网 格 中 是 使 用 它 


Flex grid :对 grid sizer 稍微 做 了 些 改变 ， 当 窗口 部 件 有 不 同 的 尺寸 
时 ， 可 以 有 更 好 的 结果 。 


Grid bag : grid sizer 系列 中 最 灵活 的 成 员 。 使 得 网 格 中 的 窗口 部 件 可 以 
更 随意 的 放置 。 


Box : 在 一 条 水 平 或 重 直 线 上 的 窗口 部 件 的 布局 。 当 尺 寸 改变 时 ， 在 控制 窗 
件 的 的 行为 上 很 灵活 。 通 常用 于 获 套 的 样式 。 可 用 于 几乎 任何 类 型 的 布局 。 


Static box :一 个 标准 的 box sizer 。 带 有 标题 和 环线 。 


如 果 你 想 要 你 的 布局 类 似 grid 或 box , wxPython 可 以 变通 ; 实际 上 ， 任 何 有 
效 的 布局 都 能 够 被 想像 为 一 个 grid 或 一 系列 box 。 


所 有 的 sizer 都 知道 它们 的 每 个 孩子 的 最 小 尺寸 。 通 常 ， sizer 也 允许 有 关 布 
局 的 额外 的 信息 息 ， 例 如 窗 ub dd A 空间 ， 它 能 够 使 一 个 窗口 部 件 的 尺寸 增 
加 多 以 填充 空间 ， 人 口 部 件 比 分 配给 它们 的 空间 小 时 如 何 对 齐 这 些 窗 口 部 件 
等 。 根 据 这 些 少 量 的 信息 sizer 用 

置 。 wxPython 中 的 每 种 sizer 对 于 同 组 子 窗口 部 件 所 产生 的 最 终 布局 是 不 同 
的 。 


贯穿 本 章 ， 你 都 会 看 到 ， 我 们 使 用 非常 相似 的 布局 来 演示 每 个 sizer 类 型 。 
下 面 是 使 用 一 个 sizer 的 三 个 基本 步骤 : 


e 创建 并 关联 sizer 到 一 个 容器 。 sizer 被 关联 到 容器 使 
用 wx.Window 的 SetSizer(sizer) 方法 。 由 于 这 是 一 个 wx,Window 的 方 
法 ， 所 以 这 意味 着 任何 wxPython 窗口 部 件 都 可 以 有 一 个 sizer ， 尽 
管 sizer 只 对 容器 类 的 窗口 部 件 有 意义 。 


e 添加 每 个 孩子 到 这 个 sizer 。 所 有 的 孩子 窗口 部 件 需要 被 单独 添加 到 
该 sizer 。 仅 仅 创建 使 用 容器 作为 父亲 的 孩子 窗口 部 件 是 不 够 的 。 还 要 将 孩 
子 窗口 部 件 添加 到 一 个 sizer ， 这 个 主要 的 方法 是 Add() 。 Add() 方法 有 
一 对 不 同 的 标记 ， 我 们 将 在 下 一 节 讨论 。 


e (可 选 的 ) 使 sizer 能 够 计算 它 的 尺寸 。 告 诉 sizer 去 根据 它 的 孩子 来 计 
算 它 的 尺寸 ， 这 通 过 在 父 窗口 对 象 上 调用 wx.window 的 Fit() 方法 或 
该 sizer 的 Fit(window) 方法 。( 这 个 窗口 方法 重 定向 到 sizer Zik) 
两 种 情况 下 ， 这 个 Fit() pam sizer 根据 它 所 掌握 的 它 的 孩子 的 情 
况 去 计算 它 的 尺寸 ， 并 且 它 调整 父 窗口 部 件 到 合适 的 尺寸 。 还 有 一 个 相关 的 方 


AA 


ik: FitInside() ， 它 不 改变 父 窗 口 部 件 的 显示 尺寸 ， 但 是 它 改变 它 虚 拟 尺 
十 这 意味 着 如 果 窗 口 部 件 是 在 一 个 可 滚动 的 面板 中 ， 那 么 wxPython 会 重 
新 计算 是 否 需要 滚动 条 。 


我 们 既 要 讨论 特定 的 sizer 的 行为 ， 也 要 讨论 所 有 sizer 的 共同 行为 。 这 就 有 
个 先后 的 问题 。 我 们 将 以 介绍 grid sizer 作为 开始 ， 它 是 最 容易 理解 的 。 之 
后 ， 我 们 将 讨论 所 有 sizer 的 共同 行为 ， 使 用 grid sizer 作为 一 个 例子 。 
(使 用 grid sizer 作为 例子 使 得 最 共同 的 行为 更 形象 化 。) 之 后 我 们 将 讨论 其 
它 的 特定 类 型 的 sizer 。 





基本 的 sizer : grid 


后 面 所 有 的 例子 使 用 了 一 个 有 点 无 聊 的 窗口 部 件 ， 目 的 是 占据 布局 中 的 空间 ， 这 样 
你 可 以 看 到 sizer 是 如 何 工 作 的 。 例 11.1 给 出 了 该 窗口 部 件 的 代码 ， 它 被 本 章 中 
的 其 余 的 例子 导入 。 从 始 至 终 ， 你 将 看 到 它 的 大 量 的 图 片 一 一 它 基 本 上 是 一 个 带 有 
标签 的 简单 的 矩形 。 


例 11.1 块 状 窗 口 ， 在 后 面 的 例子 中 用 作 一 个 窗口 部 件 


import wx 
class BlockWindow(wx.Panel): 
def _ init_ (self, parent, ID=-1, label="", 
pos=wx.DefaultPosition, size=(100, 25)): 
wx.Panel.__init__(self, parent, ID, pos, size, 
wx.RAISED_BORDER, label) 
self.label = label 
self.SetBackgroundColour ("white") 
self.SetMinSize(size) 
self.Bind(wx.EVT PAINT, self.OnPaint) 
def OnPaint(self, evt): 
sz = self.GetClientSize() 
dc = wx.PaintDC(self) 
w,h = dc.GetTextExtent(self.label) 
dc.SetFont(self.GetFont()) 
dc.DrawText(self.label, (sz.width-w)/2, (sz.height-h)/2) 


贯穿 本 章 ， 我 们 将 使 用 不 同 的 sizer 来 在 一 个 框架 中 放 上 几 个 这 样 的 块 窗口 部 
件 。 我 们 将 使 用 grid sizer 作为 开始 。 


什么 是 grid 


sizer ? 


AR 


第 十 一 章 使 用 sizer 放 置 构件 


wxPython 提供 的 最 简单 的 sizer 是 grid ° BLZ X3» —^* grid 

sizer 把 它 的 孩子 放置 在 一 个 二 维 网 格 中 。 位 于 这 个 sizer 的 孩子 列表 中 的 第 

一 个 窗口 部 件 放置 在 网 格 的 左上 角 ， 其 余 的 按 从 左 到 右 ， 从 上 到 下 的 方式 排列 ， 直 
到 最 后 一 个 窗口 部 件 被 放置 在 网 格 的 右 底部 。 图 11.1 显 示 了 一 个 例子 ， 有 九 个 窗口 
部 件 被 放置 在 一 个 3*3 的 网 格 中 。 注 意 每 个 部 件 之 间 有 一 些 间 隙 。 


图 11.1 





Figure 11.1 
A simple grid sizer layout 
当 你 调整 grid sizer 的 大 小 时 ， 每 个 部 件 之 间 的 间隙 将 随 之 改变 ， 但 是 默认 情 
况 下 ， 窗 口 部 件 的 尺寸 不 会 变 ， 并 且 始 终 按 左上 角 依 次 排列 。 图 11.2 显 示 了 调整 尺 
寸 后 的 同一 窗口 。 


图 11.2 


Figure 11.2 
The grid sizer layout, 
made bigger by the user 











例 11.2 显 示 了 用 于 产生 图 11.1 和 11.2 的 代码 。 
例 11.2 使 用 grid sizer 
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import wx 
from blockwindow import BlockWindow 
labels = "one two three four five six seven eight nine".split() 
class GridSizerFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, -1, "Basic Grid Sizer") 
sizer = wx.GridSizer(rows=3, cols=3, hgap=5, vgap=5)#¢|# 
grid sizer 
for label in labels: 
bw = BlockWindow(self, label=label) 
sizer.Add(bw，0，0)# 添 加 窗口 部 件 到 Sizer 
self.SetSizer(Ssizer)# 把 Sizer 与 框架 关联 起 来 
self .Fit() 
app = wx.PySimpleApp( ) 
GridSizerFrame().Show() 
app.MainLoop() 


你 可 以 从 例 11.2 看 到 ， 一 个 grid sizer 是 类 wx.GridSizer 的 一 个 实例 。 构 
造 函 数 显 式 地 设置 四 个 属性 ， 这 些 属性 是 grid sizer 独一无二 的 : 


wx.GridSizer(rows, cols, vgap, hgap) 


这 个 构造 函数 中 的 rows 和 cols 是 整数 ， 它 们 指定 了 网 格 的 尺寸 一 “所 能 放置 
的 窗口 部 件 的 数量 。 如 果 这 两 个 参数 之 一 被 设置 为 0， 那 么 它 的 实际 的 值 根 

据 sizer 中 的 孩子 的 数量 而 定 。 例 如 如 果 使 用 wx. GridSizer(2 , 0, 0,0)， 
E sizer 有 八 个 孩子 ， PMACKELZLA GA GR Lu GERA 


vgap 和 hgap 使 你 可 以 决定 窗口 控件 间 的 间隔 的 多 少 。 vgap 是 两 相 邻 列 间 的 
间隔 的 象 素 量 ， hgapvgap 是 两 相 邻 行 间 的 间隔 的 象 素 量 。 这 些 象 素 量 是 除了 窗口 
控件 边框 的 量 。 属 性 rows, cols ，vgap ，hgap 都 有 各 自 的 get 和 set 7 
法 GetRows() , SetRows(rows) , GetCols() , SetCols(cols) , 
GetVGap() , SetVGap(gap) , GetHGap() ,和 SetHGap(gap) ° 


grid sizer 的 尺寸 和 位 置 的 算法 是 十 分 简单 的 。 当 Fit() 第 一 次 被 调用 时 ， 
创建 初始 化 的 网 格 布局 。 ars ， 行 和 列 的 数量 根据 列表 中 元 素 的 数量 来 计 
算 。 在 grid 中 每 个 空 qus 同 。 这 个 
最 大 的 尺度 是 根据 网 格 中 宽度 最 宽 的 孩子 的 宽度 和 高 度 最 高 的 孩子 的 高 度 来 计算 
的 。 所 以 ， grid sizer 最 适合 用 于 所 有 和 孩子 相同 尺寸 的 情况 。 有 着 不 同 尺 寸 窗 
口 部 件 的 grid sizer 看 起 来 有 点 怪异 。 如 果 你 仍 想 要 一 个 类 似 grid 的 布 

局 ， 但 是 你 又 有 不 同 尺寸 的 窗口 部 件 的 话 ， 那 么 可 以 使 用 flex grid 

sizer 或 grid bag sizer 。 














如 何 对 Sizer 添 加 或 移 除 孩 子 ? 


添加 孩子 部 件 到 sizer 中 的 次 序 是 非常 重要 的 。 这 与 将 孩子 添加 到 一 个 父 窗口 部 
件 中 的 通常 情况 是 不 一 样 的 。 sizer 的 通常 的 布局 算法 要 求 一 次 添加 一 个 孩子 ， 
以 便于 决定 它们 的 显示 位 置 。 下 一 项 的 位 置 是 依赖 于 前 一 被 添加 项 的 位 置 的 。 例 
如 ，grid sizer 基于 窗口 部 件 的 次 序 来 从 左 到 右 ， 从 上 到 下 的 添加 并 显示 。 在 
多 数 情 况 下 ， 当 你 在 父 窗口 部 件 的 构造 器 中 创建 sizer 时 ， 你 将 会 按 正确 的 次 序 
添加 这 些 项 目 。 但 是 有 时 候 ， 如 果 你 在 运行 时 动态 地 改变 你 的 布局 ， 那 么 你 需要 更 
灵活 和 更 细致 。 


使 用 Add() 方法 


添加 一 个 窗口 部 件 到 一 个 sizer 中 的 最 常用 的 方法 是 Add() ， 它 将 新 的 窗口 部 

件 添 加 到 sizer 的 孩子 列表 的 尾部 。“ 添 加 到 sizer 的 孩子 列表 的 尾部 ”的 准确 的 
意思 信赖 于 该 sizer 的 类 型 ， 但 是 通常 它 意味 这 个 新 的 窗口 部 件 将 依次 显示 在 右 
下 位 置 。 Add() 方法 有 三 个 不 同 的 样式 : 


Add(window, proportion=0, flag=0, border=0, userData=None) 
Add(sizer, proportion=0, flag-0, border=0, userData=None) 
Add(size, proportion=0, flag=0, border=0, userData=None) 


第 一 个 版 本 是 你 最 常 要 用 到 的 ， 它 使 你 能 够 将 一 个 窗口 部 件 添加 到 sizer 。 


第 二 个 版 本 用 于 将 一 个 sizer 说 大 在 另 一 个 中 一 一 这 最 常用 于 box sizer * 
但 可 用 于 任何 类 型 的 sizer 。 


第 三 个 版 本 使 你 能 够 添加 一 个 wx .Size 对 象 的 空 的 空白 尺寸 或 一 个 ( 宽 ， 高 ) 元 
组 到 sizer ， 通 常用 作 一 个 分 隔 符 (例如 ， 在 一 个 工具 栏 中 ) 。 另 外 ， 这 

在 box sizer 中 最 常 使 用 ， 但 也 可 在 任何 sizer 中 使 用 以 用 于 形成 窗口 的 一 
个 空白 区 域 或 分 隔 不 同 的 窗口 部 件 。 


其 它 的 参数 影响 sizer 中 的 项 目 如 何 显示 。 其 中 的 一 些 只 对 某 种 sizer 有 

效 。 proportion 仅 被 box sizer 使 用 ， 并 当 父 窗口 尺寸 改变 时 影响 一 个 项 目 
如 何 被 绘制 。 这 个 稍 后 我 们 将 在 box sizer 时 讨论 。 

flag 参数 用 于 放置 位 标记 ， 它 控制 对 齐 、 边 框 和 调整 尺寸 。 这 些 项 将 在 后 面 的 章 
节 中 讨论 。 如 果 在 flag 参数 中 指定 了 边框 ， 那 么 border 参数 包含 边框 的 宽 

度 。 如 果 sizer 的 算法 需要 ， userData 参数 可 被 用 来 传递 额外 的 数据 。 如 果 你 
正在 设计 一 个 自 定 义 的 sizer ， 那 么 你 可 以 使 用 该 参数 。 

使 用 insert() 方法 


这 里 有 用 于 将 新 的 窗口 部 件 插入 到 sizer 中 不 同位 置 的 方法 。 insert() 方法 使 
你 能 够 按 任 意 的 索引 来 放置 新 的 窗口 部 件 。 它 也 有 三 个 形式 : 


Insert(index, window, proportion=0, flag=0, border=0, userData=N 
one) 
Insert(index, sizer, proportion=0, flag=0, border=0, userData=No 
ne) 
Insert(index, size, proportion=0, flag=0, border=0, userData=Non 


e) 
使 用 Prepend() 方法 
该 方法 将 新 的 窗口 部 件 、 sizer 或 空白 添加 到 sizer 的 列表 的 开头 ， 这 意味 所 
添加 的 东西 将 被 显示 到 左上 角 : 


Prepend(window, proportion=0, flag=0, border=0, userData=None) 
Prepend(sizer, proportion=0, flag=0, border=0, userData=None) 
Prepend(size, proportion=0, flag=0, border=0, userData=None) 
图 11.3 显 示 了 在 例 11.1 中 如 果 Add() 替换 为 Prepend() 后 的 布局 。 
图 11.3 











Figure 11.3 
A grid layout with items prepended 


如 果 sizer 已 在 屏幕 上 显示 了 ， 而 你 又 要 给 sizer 添加 一 个 新 的 项 目 ， 那 么 你 
需要 调用 sizer 的 Layout() 方法 来 迫使 sizer 自己 重新 排列 ， 以 容纳 新 的 
项 o 


使 用 Detach() 方法 


ATM sizer 中 移 除 一 项 ， 你 需要 调用 Detach() 方法 ， 它 从 sizer 中 移 除 项 
目 ， 但 是 没有 销毁 该 项 目 。 这 对 于 你 以 后 再 使 用 它 是 有 用 的 。 使 用 Detach() 有 三 
种 方法 。 你 可 以 将 你 想 要 移 除 的 窗口 、 sizer 对 象 、 对 象 的 索引 作为 参数 传递 

给 Detach() 


Detach(window) 
Detach(sizer ) 
Detach( index ) 


在 这 三 种 情况 中 ， Detach() FARO-+*AH RA? CRANRA EG AW RMT 
如 果 你 试图 移 除 sizer 中 没有 的 项 ， 将 返回 false 。 和 你 曾 见 过 的 其 它 的 
则 除 方法 不 同 ， Detach() 不 返回 被 删除 的 项 目 ， 所 以 如 果 你 想 要 得 到 它 的 话 ， 你 
需要 之 前 用 一 个 变量 来 存储 对 它 的 引用 。 





从 sizer 中 删除 项 目 ， 不 会 自动 改变 在 屏幕 上 的 显示 。 你 需要 调用 Layout() 7 
法 来 执行 重 绘 。 


你 可 以 得 到 一 个 包含 了 窗口 的 sizer 的 引用 ， 这 通过 使 
用 wx.Window 的 GetContainingSizer() 方法 。 如 果 该 窗口 部 件 没有 被 包含 
在 sizer 中 ， 那 么 该 方法 返回 None ° 


Sizer 是 如 何 管理 它 的 孩子 的 尺寸 和 对 齐 的 ? 


当 一 个 新 的 项 目 被 添加 到 一 个 sizer 时 ， sizer 就 使 用 这 个 项 目的 初始 尺寸 或 
根据 它 的 布局 计算 给 出 恰当 的 尺寸 (如 果 它 的 初始 尺寸 没有 设置 ) o MAE 

说 ， sizer 不 调整 一 个 项 目的 大 小 ， 除 非 要 求 ， 这 通常 发 生 在 一 个 窗口 尺寸 的 改 
变 时 。 

3 sizer 的 父 窗 口 部 件 改变 了 尺寸 时 ， sizer 需要 改变 它 的 组 分 的 尺寸 。 默 认 
情况 下 ， sizer 保持 这 些 窗口 部 件 的 对 齐 方式 不 变 。 

当 你 添加 一 个 窗口 部 件 到 sizer 时 ， 可 以 通过 给 flag 参数 一 个 特定 值 来 调整 该 


窗口 部 件 的 尺寸 改变 行为 。 图 11.4 展 示 了 在 用 户 放 大 窗口 后 ， 几 个 不 同 标 记 应 用 于 
这 个 基本 的 grid sizer 的 结果 。 


图 11.4 


Figure 11.4 
A grid with resizing widgets 














例 11.3 显 示 了 产生 图 11.4 的 代码 。 除 了 在 窗口 部 件 被 添加 到 sizer 时 应 用 了 一 个 
标记 字典 外 ， 其 它 的 与 前 一 个 例子 相同 。 


例 11.3 使 用 了 用 于 对 齐 和 调整 尺寸 的 标记 的 一 个 grid sizer 


import wx 
from blockwindow import BlockWindow 
labels = "one two three four five six seven eight nine".split() 
# 对 齐 标记 
flags = {"one": wx.ALIGN_BOTTOM, "two": wx.ALIGN_CENTER, 
"four": wx.ALIGN RIGHT, "six": wx.EXPAND, "seven": wx.E 
XPAND, 
"eight": wx.SHAPED} 
class TestFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init__(self, None, -1, "GridSizer Resizing") 
sizer - wx.GridSizer(rows-3, cols-3, hgap-5, vgap-5) 
for label in labels: 
bw = BlockWindow(self, label-label) 
flag - flags.get(label, 0) 
sizer.Add(bw, 0, flag) 
self.SetSizer(sizer) 
self.Fit() 
app - wx.PySimpleApp() 
TestFrame().Show() 
app.MainLoop() 


在 这 个 例子 中 ， 窗 口 部 件 " one ,'" two ,” $e“ four ”分 别 使 

用 wx.ALIGN BOTTOM , wx.ALIGN_CENTER , and  wx.ALIGN RIGHT 标记 改变 
它们 的 对 齐 方式 。 当 窗口 大 小 改变 时 ， 你 可 以 看 到 效果 ， 部 件 * three "没有 指定 
一 个 标记 ， 所 以 它 按 左 上 角 对 齐 。 窗 口 " six "Fe" seven " 均 使 用 

了 wx.EXPAND 标记 来 告诉 sizer 改变 它们 的 尺寸 以 填 满 格子 ， 而 窗口 部 

TF" eight "使 用 wx.SHAPED 来 改变 它 的 尺寸 ， 以 保持 比例 不 变 。 


表 11.2 显 示 与 尺寸 调整 和 对 齐 相 关 的 flag 的 值 。 
表 11.2 尺寸 调整 和 对 齐 行 为 标记 


按照 TOURER 分 配 的 空间 (格子 ) 的 底 
部 对 齐 


放置 窗 ia ae) ， 使 窗口 部 件 的 中 心 处 于 其 
所 分 配 的 空间 的 中 心 。 


WX.ALIGN CENTER HORIZONTAL 在 它 所 处 的 格子 中 ， 水 平 居 中 。 


WX.ALIGN BOTTOM 


WX.ALIGN CENTER 


wX.ALIGN CENTER. VERTICAL 在 它 所 处 的 格子 中 ， 重 直 尼 中 。 
wX.ALIGN. LEFT 2T 它 所 处 的 格子 左边 缘 。 默认 行 
wx.ALIGN TOP ros 所 处 的 格子 的 上 边缘 。 这 是 默认 的 
wx . EXPAND 十 满 它 所 处 的 格子 空间 o 

wx. FIXED. MINSIZE 保持 国定 项 的 最 小 尺寸 。 


与 wx.EXPAND 相同 。 但 比 之 少 两 个 字 
节约 了 时 间 。 

窗口 部 件 的 尺寸 改变 时 ， 只 在 一 个 方向 上 

NASB REL 填 满 格子 ， 另 一 个 方向 上 按 窗 口 部 件 原先 

的 形状 尺寸 的 比 列 填充 。 


wx . GROW 


这 些 标 记 可 以 使 用 | 来 组 合 ， 有 时 ， 这 些 组 合 会 很 有 意思 。 wx.ALIGN TOP | 
wx.ALIGN_RIGHT 使 得 窗口 部 件 位 于 格子 的 右上 角 。 (注意 ， 互相 排斥 的 标记 组 
合 如 wx.ALIGN TOP | wx.ALIGN BOTTOM 中 ， 默 认 的 标记 不 起 作用 ， 这 是 因为 默 
认 标 记 的 相应 位 上 是 0， 在 或 操作 中 没有 什么 影响 ) 。 


还 有 一 些 方法 ， 你 可 以 用 来 在 运行 时 处 理 sizer 或 它 的 孩子 的 尺寸 和 位 置 。 你 可 
以 使 用 方法 GetSize() 和 GetPosition() 来 得 到 sizer 的 当前 尺寸 和 位 置 

— 这 个 位 置 是 sizer 相对 于 它 所 关联 的 容器 的 。 如 果 sizer KZA — 

个 sizer 中 ， 那 么 这 些 方法 是 很 有 用 的 。 你 可 以 通过 调用 SetDimension(x y, 
width , height) 方法 来 指定 一 个 sizer 的 尺寸 ， 这 样 sizer 将 根据 它 的 新 
尺寸 和 位 置 重新 计算 它 的 孩子 的 尺寸 。 


能 够 为 sizer 或 它 的 孩子 指定 一 个 最 小 的 尺寸 吗 ? 


sizer Nee A a URS sizer 或 它 的 孩子 指定 一 

尺寸 的 能 力 。 一 般 你 不 想 要 一 个 控件 或 一 个 sizer 小 于 一 个 特定 的 尺寸 ， 
常 因 为 这 样 会 导致 文本 被 窗口 部 件 的 边缘 截断 。 或 在 一 个 谋 套 的 sizer 中 ， 控 

cra EX RHR oA 7 38b RA MAH ^ ACT VALOR ° 


图 11.5 显 示 了 对 一 个 特定 的 窗口 部 件 设 置 最 小 尺寸 的 一 个 例子 。 该 窗口 的 尺寸 已 被 
用 户 改 变 了 。 


图 11.5 


! 
CGridSizer Test m | aj 








Figure 11.5 
A grid sizer with the size 
of one item set explicitly 


例 11.4 展 示 了 产生 该 图 的 代码 。 它 类 似 于 基本 的 grid 的 代码 ， 其 中 增加 了 一 
个 SetMinSize() 调用 。 











例 11.4 使 用 最 小 尺寸 设置 的 grid sizer 


import wx 
from blockwindow import BlockWindow 
labels = "one two three four five six seven eight nine".split() 


class TestFrame(wx.Frame): 
def _init_ (self): 
wx.Frame.__init__(self, None, -1, "GridSizer Test") 
sizer = wx.GridSizer(rows=3, cols=3, hgap=5, vgap=5) 
for label in labels: 
bw = BlockWindow(self, label=label) 
sizer.Add(bw, 0, 0) 
center = self.FindwindowByName("five") 
center .SetMinSize( (150,50) ) 
self .SetSizer(sizer) 
self .Fit() 
app = wx.PySimpleApp() 
TestFrame().Show( ) 
app .MainLoop( ) 


当 一 个 sizer 被 创建 时 ， 它 根据 它 的 孩子 的 综合 的 最 小 尺寸 (最 小 的 宽度 和 最 小 
的 高 度 ) 隐 含 地 创建 一 个 最 小 尺寸 。 多 数控 件 都 知道 它们 最 小 化 的 “最 佳 尺 

寸 "， sizer 查询 该 值 以 确定 默认 的 布局 。 如 果 显 式 地 使 用 一 个 尺寸 值 来 创建 一 个 
控件 ， 那 么 这 个 设置 的 尺寸 值 履 盖 所 计算 出 的 最 佳 尺 寸 。 一 个 控件 的 最 小 尺寸 可 以 
使 用 窗口 的 方法 SetMinSize(width , height) 和 SetSizeHints(minw , 

minH , maxw , maxH) 来 设置 第 二 个 方法 使 你 也 能 够 指定 一 个 最 大 尺寸 。 如 
果 一 个 窗口 部 件 的 属性 (通常 是 所 显示 的 字体 或 文本 标签 ) 改变 ， 该 窗口 部 件 通常 
将 调整 它 的 最 佳 尺寸 。 


如 果 一 个 窗口 有 相关 的 sizer ， 那 么 这 个 容器 窗口 的 最 佳 尺 寸 由 它 的 sizer 来 

确定 。 如 果 没 有 ， 那 么 该 窗口 的 最 佳 尺 寸 就 是 足够 大 到 显示 所 有 子 控件 的 尺寸 。 如 
果 该 窗口 没有 和 孩子， 那么 它 使 用 所 设置 的 最 小 尺寸 为 最 佳 尺 寸 。 如 果 上 述 都 没有 ， 
那么 该 容器 窗口 的 当前 尺寸 作为 其 最 佳 尺寸 。 


你 可 以 使 用 GetMinsize() 来 访问 整个 sizer 的 最 小 尺寸 。 如 果 你 想 为 整 
个 sizer 设置 一 个 较 大 的 最 小 尺寸 ， 那 么 你 可 以 使 
用 setMinSize(width , height) ， 该 函数 也 可 以 使 用 一 个 wx.Size 实例 作为 





参数 一 一 SetMinSize(size) ， 尽 管 在 wxPython 中 你 很 少 显 式 地 创建 一 
个 wx.Size 。 在 最 小 尺寸 已 被 设置 后 GetMinsize() 返回 设置 的 尺寸 或 孩子 的 
综合 的 尺寸 。 


如 果 你 只 想 设 置 sizer 内 的 一 个 特定 的 孩子 的 最 小 尺寸 ， 那 么 使 
用 sizer 的 SetItemMinSize() 方法 。 它 也 有 三 个 形式 : 


SetItemMinSize(window, size) 
SetItemMinSize(sizer, size) 
SetItemMinSize(index, size) 


iX € > AX window 和 sizer 必须 是 一 个 sizer 实例 的 孩子 。 如 果 需 要 的 话 ， 

Fi EPS REM PIR LS SAX sizer 。 参 数 index 是 sizer 的 
孩子 列表 中 的 索引 。 参 数 size 是 一 个 wx.Size 对 象 或 一 个 ( 宽 ， 高 ) 元 组 ， 它 

是 sizer 中 的 项 目 被 设置 的 最 小 尺寸 。 如 果 你 设置 的 最 小 尺寸 比 窗口 部 件 当前 的 
尺寸 大 ， 那 么 它 自动 调整 。 你 不 能 根据 sizer 来 设置 最 大 尺寸 ， 只 能 根据 窗口 部 
件 来 使 用 SetSizeHints() 设置 。 


sizer 如 何 管理 每 个 孩子 的 边框 ? 


wxPython sizer 能 够 使 它 的 一 个 或 所 有 孩子 有 一 个 边框 。 边 框 是 连续 数量 的 空 
白 空 间 ， 它 们 分 离 相 邻 的 窗口 部 件 。 当 sizer 计算 它 的 孩子 的 布置 时 ， 边 框 的 尺 
寸 是 被 考虑 进去 了 的 ， 和 孩子 的 尺寸 不 会 小 于 边框 的 宽度 。 当 sizer 调整 尺寸 时 ， 
边框 的 尺寸 不 会 改变 。 

图 11.6 显 示 了 一 个 10 像 素 的 边框 。 在 每 行 中 ， 中 间 的 元 素 四 边 都 有 边框 围绕 ， 而 其 
它 的 只 是 部 分 边 有 边框 。 增 加 边框 不 会 使 窗口 部 件 更 小 ， 而 是 使 得 框架 更 大 了 。 


图 11.6 
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Figure 11.6 The grid sizer with a border 


例 11.5 是 产生 图 11.6 的 相关 代码 。 它 和 基本 的 grid sizer 相似 ， 只 是 我 们 增加 
了 一 个 边框 值 字典 ， 并 给 Add() 一 个 10 像 素 的 边框 。 


例 11.5 使 用 边框 设置 的 grid sizer 代码 


import wx 
from blockwindow import BlockWindow 
labels = "one two three four five six seven eight nine".split() 
# 边 框 标 记 
flags = {"one": wx.BOTTOM, "two": wx.ALL, "three": wx.TOP, 
"Four": wx.LEFT, "five": wx.ALL, "six": wx.RIGHT, 
"seven": wx.BOTTOM | wx.TOP, "eight": wx.ALL, 
"nine": wx.LEFT | wx.RIGHT} 
class TestFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, -1, "GridSizer Borders") 
sizer - wx.GridSizer(rows-3, cols-3, hgap-5, vgap-5) 
for label in labels: 
bw = BlockWindow(self, label-label) 
flag - flags.get(label, 0) 
sizer.Add(bw，0，flag，19)# 添 加 指定 边框 的 窗口 部 件 
self .SetSizer(sizer) 
self .Fit() 
app = wx.PySimpleApp( ) 
TestFrame().Show() 
app.MainLoop() 


要 在 一 个 sizer 中 的 窗口 部 件 周围 放置 边框 ， 需 要 两 步 。 第 一 步 是 当 窗 口 部 件 被 
添加 到 该 sizer 时 ， 传 递 额外 的 标记 给 flags 参数 。 你 可 以 使 用 标 

记 wx.ALL 来 指定 边框 围绕 整个 窗口 部 件 ， 或 使 用 wx.BOTTOM , wx.LEFT , 
wxX.RIGHT , wx.TOP 来 指定 某 一 边 有 边框 。 这 些 标记 当然 可 以 组 合成 你 想 要 的 ， 
如 wx.RIGHT | wx.BOTTOM 将 使 你 的 窗口 部 件 的 右边 和 底 边 有 边框 。 由 于 边框 、 
尺寸 调整 、 对 齐 这 些 信 息 都 是 经 由 flags 参数 ， 所 以 对 于 同一 个 窗口 部 件 ， 你 通 
常 必 须 将 三 种 标记 组 合 起 来 使 用 。 


在 你 传递 了 边框 信息 到 flags 参数 后 ， 你 也 需要 传递 边框 宽度 的 像素 值 
给 border 参数 。 例 如 ， 下 面 的 调用 将 添加 窗口 部 件 到 sizer 列表 的 尾部 ， 并 使 
该 窗口 部 件 的 周围 有 5 个 像素 宽度 的 边框 : 


sizer.Add(widget, 0, wx.ALL | wx.EXPAND, 5) 
该 部 件 然后 将 扩展 以 填充 它 的 有 效 空 间 ， 且 四 周 始终 留 有 5 个 像素 的 空白 。 


使 用 其 它 类 型 的 Sizer 


我 们 已 经 讨论 了 基本 的 sizer ， 现 在 我 们 可 以 转向 更 复杂 和 更 灵活 

的 sizer 了 。 其 中 两 个 ( flex grid sizer 和 grid bag sizer ) 本 
质 上 是 grid 的 变种 。 另 外 两 个 ( box 和 static box sizer ) 使 用 一 个 不 
同 的 和 更 灵活 的 布局 结构 。 
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第 十 一 章 使 用 Sizer 放 置 构件 


什么 是 flex grid sizer ? 

flex grid sizer 是 grid sizer 的 一 个 更 灵活 的 版 本 。 它 与 标准 
的 grid sizer 几乎 相同 ， 除 了 下 面 的 例外 : 

1、 每 行 和 每 列 可 以 有 各 自 的 尺寸 。 


2、 默 认 情况 下 ， 当 尺寸 调整 时 ， 它 不 改变 它 的 单元 格 的 尺寸 。 如 果 需 要 的 话 ， 你 
可 以 指定 哪 行 或 哪 列 应 该 增长 。 


3、 它 可 以 在 两 个 方向 之 一 灵活 地 增长 ， 意 思 是 你 可 以 为 个 别 的 子 元 素 指定 比 列 
量 ， 并 且 你 可 以 指定 国定 方向 上 的 行为 。 


图 11.7 显 示 了 一 个 flex grid sizer ， 它 的 布局 也 是 9 个 单元 格 。 这 里 的 中 间 
单元 格 更 大 。 


图 11.7 





Figure 11.7 A simple flex grid sizer 


与 图 11.5 相 比较 ， 对 于 相同 的 布局 ， 图 11.5 中 每 个 单元 格 的 尺寸 与 中 间 对 象 的 相 
F > Æ flex grid sizer 中 ， 单 元 格 的 尺寸 大 小 根据 它 所 在 的 行 和 列 来 定 。 
它们 宽度 是 该 列 中 宽度 最 大 的 项 目的 宽度 ， 它 们 的 高 度 是 该 行 中 宽度 最 高 的 项 目的 
宽度 。 在 这 里 ， 项 目 * four PRA” six "的 单元 格 的 高 度 比 项 目 本 身 的 高 度 更 
高 ， 因 为 其 同行 中 的 项 目 " five ”， 而 " two "fe" seven "的 单元 格 的 宽度 也 更 
55, °“ one ,"* three ,”“ seven ,” 和 “ nine ”的 单元 格 是 正常 的 尺寸 ， 并 且 不 受 
较 大 的 窗口 部 件 的 影响 。 


图 11.8 展 示 了 当 调 整 窗口 尺寸 时 ， flex grid sizer 的 默认 行为 一 一 单元 格 
的 尺寸 不 改变 。 


图 11.8 
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Figure 11.8 
A flex grid sizer being resized. 














例 11.6 显 示 了 产生 了 图 11.8 的 代码 


例 11.6 创建 一 个 flex grid sizer 


297 


import wx 
from blockwindow import BlockWindow 
labels = "one two three four five six seven eight nine".split() 
class TestFrame(wx.Frame): 
def __init_ (self): 
wx.Frame.__init__(self, None, -1, "FlexGridSizer") 
sizer = wx.FlexGridSizer(rows=3, cols=3, hgap=5, vgap=5) 
for label in labels: 
bw = BlockWindow(self, label=label) 
sizer .Add(bw, ©, 0) 
center = self.FindwindowByName("five") 
center .SetMinSize( (150,50) ) 
self .SetSizer(sizer) 
self .Fit() 
app = wx.PySimpleApp() 
TestFrame().Show() 
app.MainLoop() 


一 个 flex grid sizer X wx.FlexGridSizer 的 一 个 实例 。 
类 wx.FlexGridSizer 是 wx.GridSizer 的 子 类 ， 所 以 wx.GridSizer 的 属性 
方法 依然 有 效 。 wx.FlexGridSizer 的 构造 函数 与 其 父 类 的 相同 : 


wx.FlexGridSizer(rows , cols , vgap , hgap) 


AT sizer 扩展 时 ， 使 一 行 或 列 也 扩展 ， 你 需要 使 用 适当 的 方法 显 式 地 告诉 
该 sizer 该 行 或 列 是 可 扩展 的 : 


AddGrowableCol(idx, proportion=0) 
AddGrowableRow(idx, proportion=0) 


3 sizer 水 平 扩展 时 ， 关 于 新 宽度 的 默认 行为 被 等 同 地 分 配给 每 个 可 扩展 的 列 。 
同样 ， 一 个 重 直 的 尺寸 调整 也 被 等 同 地 分 配给 每 个 可 扩展 的 行 。 要 改变 这 个 默认 的 
行为 并 且 使 不 同 的 行 和 列 有 不 现 的 扩展 比率 ， 你 需要 使 用 proportion 参数 。 如 
A proportion 参数 被 使 用 了 ， 那 么 与 该 参数 相关 的 新 的 空间 就 被 分 配给 了 相应 
的 行 或 列 。 例 如 ， 如 果 你 有 两 个 尺寸 可 调整 的 行 ， 并 且 它 们 的 proportion 分 别 
是 2 和 1， 那 么 这 第 一 个 行将 得 到 新 空间 的 2/3， 第 二 行将 得 到 1/3。 图 11.9 显 示 使 

用 proportional (〈 比 列 ) 空间 的 flex grid sizer 。 在 这 里 ， 中 间 行 和 列 
所 占 的 比例 是 2 和 5， 两 端的 行 和 列 所 占 的 比例 是 1。 


图 11.9 
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Figure 11.8 
A flex grid sizer being resized. 


正如 你 可 以 看 到 的 ， 当 所 有 的 单元 阁 增 大 时 ， 中 间 的 行 和 列 的 增 大 是 两 端的 两 倍 。 


窗口 部 件 的 没有 改变 尺寸 以 卉 表 充 它们 的 单元 格 ， 虽 然 可 以 通过 在 当 它 们 被 添加 
到 sizer 时 使 用 wx.EXPAND 来 实现 。 例 11.7 显 示 了 产生 图 11.9 的 代码 。 














例 11.7 
import wx 
from blockwindow import BlockWindow 
labels = "one two three four five six seven eight nine".split() 


class TestFrame(wx.Frame): 
def — init (self): 
wx.Frame. init (self, None, -1, "Resizing Flex Grid Si 
zer") 
sizer = wx.FlexGridSizer(rows=3, cols-3, hgap-5, vgap=5) 
for label in labels: 
bw = BlockWindow(self, label-label) 
sizer.Add(bw, 0, 0) 
center = self.FindwindowByName("five") 
center .SetMinSize( (150,50) ) 
sizer .AddGrowableCol(0, 1) 
sizer .AddGrowableCol(1, 2) 
sizer .AddGrowableCol(2, 1) 
sizer .AddGrowableRow(0, 1) 
sizer .AddGrowableRow(1, 5) 
sizer .AddGrowableRow(2, 1) 
self .SetSizer(sizer) 
self .Fit() 
app = wx.PySimpleApp( ) 
TestFrame().Show() 
app.MainLoop() 


如 果 你 对 一 个 可 扩展 的 行 或 列 使 用 了 比例 尺寸 ， 那 么 你 需要 对 该 方向 上 的 所 有 可 扩 
展 的 行 或 列 指定 一 个 比例 量 ， 否 则 你 将 得 到 一 个 粮 糕 的 效果 。 


在 flex grid sizer 中 还 有 另外 一 个 机 制 用 于 控制 窗口 部 件 的 增长 ( 执 不 执 
行 先前 AddGrowable * 方 法 的 设置 ) 。 默 认 情 况 下 ， 上 比例 尺寸 适用 于 flex 

grid 的 两 个 方向 ; 但 是 你 可 以 通过 使 

用 SetFlexibleDirection(direction) 方法 来 指定 仅 某 个 方向 应 该 按 比 例 调整 
尺寸 ， 参 数 direction 的 值 可 以 是 : wx.HORIZONTAL , wx.VERTICAL , 

或 wx.BOTH (RUAA) 。 然 后 你 可 以 使 用 SetNonFlexibleGrowMode(mode) 方 
法 来 指定 另 一 个 方向 上 的 行为 。 例 如 ， 如 果 你 调用 


了 SetFlexibleDirection(wx.HORIZONTAL) 方法 ， 列 的 行为 就 遵 
循 AddGrowableCol() ， 然 后 调用 SetNonFlexibleGrowMode() 来 定义 行 的 行 
为 。 表 11.3 显 示 了 mode 参数 的 有 效 值 。 


表 11.3 

wx.FLEX GROWMODE ALL : flex grid 在 没有 使 

用 SetFlexibleDirection HA MEF [PF] X7 3& PEZ. XE CARS Ro oo RRA 
用 AddGrowable 方法 设置 的 任何 行为 所 有 的 单元 格 都 将 被 调整 尺寸 ， 不 管 它 
们 的 比例 或 它们 是 否 被 指定 为 可 扩展 (增长 ) 的 。 

wx.FLEX GROWMODE NONE : 在 没有 使 用 SetFlexibleDirection * 的 方向 上 的 单 
元 格 的 尺寸 不 变化 ， 不 管 它们 是 否 被 指定 为 可 增长 的 。 





wx.FLEX_GROWMODE_SPECIFIED : 在 没有 使 用 SetFlexibleDirection * 的 方向 
上 d 只 有 那些 可 增长 的 单元 格 才 增长 o 但 是 sizer 将 忽略 任何 的 比例 信息 并 等 同 
地 增长 那些 单元 格 。 这 是 一 个 默认 行为 。 


上 面 段落 中 所 讨论 的 SetFlexibleDirection 和 SetNonFlexibleGrowMode 方 
法 都 有 对 应 的 方 

ik: GetFlexibleDirection() 和 GetNonFlexibleGrowMode() ， 它 们 返回 整 
型 标记 。 在 上 表 中 要 强调 的 是 ， 任 何 使 用 这 些 方 法 来 指定 的 设置 将 取代 通 

过 AddGrowableCol() 和 AddGrowableRow() 创建 的 设置 。 


什么 是 grid bag sizer? 


grid bag sizer 是 对 flex grid sizer 进一步 的 增强 。 在 grid 
bag sizer 中 有 两 个 新 的 变化 : 


1、 能 够 将 一 个 窗口 部 件 添加 到 一 个 特定 的 单元 格 。2、 能 够 使 一 个 窗口 部 件 跨越 几 
个 单元 格 (就 像 HTML 表单 中 的 表格 所 能 做 的 一 样 ) 。 


图 11.10 
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Figure 11.10 
A sample grid bag sizer 





图 11.10 显 示 了 一 个 grid bag sizer 的 示例 。 它 与 本 章 前 面 的 例子 很 相似 ， 
只 是 增加 了 新 的 窗口 部 件 以 展示 跨行 和 跨 列 。 


例 11.8 显 示 了 产生 图 11.10 的 代码 。 注 意 这 里 的 Add() 方法 与 以 前 的 看 起 来 有 点 不 
同 。 


例 11.8 Grid bag sizer 示例 代码 


#coding=utf -8 


#! python 

import wx 

from blockwindow import BlockWindow 

labels = "one two three four five six seven eight nine".split() 


class TestFrame(wx.Frame): 
def — init (self): 
wx.Frame. init__(self, None, -1, "GridBagSizer Test") 
sizer = wx.GridBagSizer(hgap-5, vgap-5) 
for col in range(3): 
for row in range(3): 
bw = BlockWindow(self, label-labels[row*3 + col] 


sizer.Add(bw, pos-(row,col)) 


bw = BlockWindow(self, label="span 3 rows") 
sizer.Add(bw, pos=(0,3), span=(3,1), flag=wx.EXPAND) 
35 5| 

bw = BlockWindow(self, label="span all columns") 
sizer.Add(bw, pos=(3,0), span=(1,4), flag=wx.EXPAND) 
# 使 最 后 的 行 和 列 可 增长 
sizer .AddGrowableCol(3) 
sizer .AddGrowableRow(3) 
self .SetSizer (sizer) 
self.Fit() 

app = wx.PySimpleApp( ) 

TestFrame().Show() 

app.MainLoop() 


grid bag sizer Æ wx.GridBagSizer 的 实 
f| > wx.GridBagSizer 是 wx.FlexGridSizer 的 一 个 子 类 。 这 意味 着 所 
有 flex grid sizer 的 属性 ， grid bag sizer 都 适用 。 


wx.GridBagSizer 的 构造 函数 与 它 的 父 类 有 点 不 同 : 


wx.GridBagSizer(vgap=0, hgap=0) 


在 一 个 grid bag sizer 中 ， 你 不 必 去 指定 行 和 列 的 数量 ， 因 为 你 可 以 直接 将 
子 项 目 添加 进 特定 的 单元 格 sizer 将 据 此 计算 出 网 格 的 尺度 。 





在 grid bag sizer 上 使 用 Add() 方法 


对 于 grid bag sizer ， Add() 方法 与 别 的 sizer 不 同 。 它 有 四 个 可 选 的 
形式 : 


1 Add(window, pos, span=wx.DefaultSpan, flag-0, border=0, 
userData=None) 

2 Add(sizer, pos, span=wx.DefaultSpan, flag=0, border=0, 
userData=None ) 

3 Add(size, pos, span=wx.DefaultSpan, flag=0, border=0, 
userData=None) 

4 AddItem(item) 


这 些 看 起 来 应 该 很 熟悉 ， 在 运行 上 也 与 通常 的 sizer 的 方法 相似 。 window , 
sizer , size , flag , border ,和 userData 参数 的 行为 与 通常 sizer 的 
方法 中 的 是 相同 的 。 pos 参数 代表 sizer 中 的 窗口 部 件 要 赋予 的 单元 格 。 技 术 
上 讲 ， pos 参数 是 类 wx.GBPosition 的 一 个 实例 ， 但 是 通过 wxPython 变换 ， 
你 可 以 仅 传递 一 个 ( 行 , 列 ) 形 式 的 元 组 ， grid bag 的 左上 角 是 (0.0) 。 


同样 ， span 参数 代表 窗口 部 件 应 该 占据 的 行 和 列 的 数量 。 它 是 类 wx.GBSpan 的 
一 个 实例 ， 但 是 ， wxPython 也 使 你 能 够 传递 一 个 ( 行 的 范围 ， 列 的 范围 ) 形 式 的 元 
组 。 如 果 跨 度 没有 指定 ， 那 么 默认 值 是 (1,1)， 这 意味 该 窗口 部 件 在 两 个 方向 都 只 能 
占据 一 个 单元 格 。 例 如 ， 要 在 第 二 行 第 一 列 放 置 一 个 窗口 部 件 ， 并 且 使 它 占据 三 行 
两 列 ， 那 么 你 将 这 样 调用 : Add(widget , (1, 0), (3, 2)) (索引 是 从 0 开始 的 ) 。 


Additem 方法 的 item 参数 是 类 wx.GBSizerItem 的 一 个 实例 ， 它 包含 

了 grid bag sizer 放置 项 目 所 需要 的 全 部 信息 。 你 不 太 可 能 需要 直接 去 创建 
一 个 wx.GBSizerltem 。 如 果 你 想 去 创建 一 个 ， 那 么 它 的 构造 函数 的 参数 

与 grid bag sizer 的 其 它 Add() 方法 相同 。 一 旦 你 有 了 一 

个 wx.GBSizerItem ， 这 儿 有 许多 的 get * 方 法 使 你 能 够 访问 项 目的 属性 ， 也 许 
这 最 有 用 的 是 GetWindow() ， 它 返回 实际 显示 的 窗口 部 件 。 


由 于 项 目 是 使 用 行 和 列 的 索引 以 及 跨度 被 添加 到 一 个 grid bag sizer 的 ， 所 
以 项 目 被 添加 的 顺序 不 必 按 照 其 它 sizer 所 要 求 的 对 应 它们 的 显示 顺序 。 这 使 得 

跟踪 哪个 项 实际 显示 在 哪个 单元 格 有 一 点 头痛 。 表 11.4 列 出 了 几 个 方法 ， grid 
bag sizer 通过 它们 来 使 你 对 项 目的 跟踪 较为 容易 。 


表 11.4 Grid bag sizer 管理 项 目的 方法 


CheckForIntersection(item , excludeItem = None) 
CheckForIntersection(pos , span , excludeItem = None) : 将 给 定 的 项 目 
或 给 定 的 位 置 和 跨度 同 sizer 中 的 项 目 进行 比 对 。 如 果 有 任 一 项 与 给 定 项 目的 位 
BRA CAG BAIS Se > WARE True 。 excludeItem 是 一 个 可 选 的 项 ， 它 
不 被 包括 在 比 对 中 (或 许 是 因为 它 正 在 测试 中 ) 9 pos 参数 是 一 

个 wx.GBPosition 或 一 个 元 组 。 span 参数 是 一 个 wx.GPSpan 或 一 个 元 组 。 


FindItem(window)  FindItem(sizer) :返回 对 应 于 给 定 的 窗口 
或 sizer 的 wx.GBSizerItem 。 如 果 窗 口 或 sizer 不 在 grid bag PRB 
E] None 。 这 个 方法 不 递归 检查 其 中 的 子 sizer 。 


FindItemAtPoint(pt) : pt 参数 是 对 应 于 所 包含 的 框架 的 坐标 的 一 
个 wx.Point 实例 或 一 个 Python 元 组 。 这 个 方法 返回 位 于 该 点 
的 wx.GBSizerItem 。 如 果 这 个 位 置 在 框架 的 边界 之 外 或 如 果 该 点 没 


有 sizer 项 目 ， 则 返回 None 。 


FindItemAtPosition(pos) : 该 方法 返回 位 于 给 定单 元 格 位 置 
的 wx.GBSizerItem ， 参 数 pos 是 一 个 wx.GBPosition 或 一 个 Python 元 
组 。 如 果 该 位 置 在 sizer 的 范围 外 或 该 位 置 没 有 项 目 ， 则 返回 None 。 


FindItemwithData(userData) : 返回 grid bag 中 带 有 给 定 的 userData 对 
象 的 一 个 项 目的 wx.GBSizerItem ° 


Grid bag 也 有 一 对 能 够 用 于 处 理 单元 格 尺 寸 和 项 目 位 置 的 属性 。 在 grid 

bag 被 布局 好 并 显示 在 屏幕 上 后 ， 你 可 以 使 用 方法 Getcellsize(row , 

col) 来 获取 给 定 的 单元 格 显示 在 屏幕 上 的 尺寸 。 这 个 尺寸 包括 了 由 sizer AF 
所 管理 的 水 平和 垂直 的 间隔 。 你 可 以 使 用 方法 GetEmptyCellsize() 得 到 一 个 空 
单元 格 的 尺寸 ， 并 且 你 可 以 使 用 SetEmptyCellSize(sz) 改变 该 属性 ， 这 里 

的 sz 是 一 个 wx.Size 对 象 或 一 个 Python 元 组 。 


你 也 可 以 使 用 方法 GetItemPosition() 和 GetItemSpan() 来 得 到 grid 

bag 中 的 一 个 对 象 的 位 置 或 跨度 。 这 两 个 方法 要 求 一 个 窗口 ， 一 个 sizer 或 一 

个 索引 作为 参数 。 这 个 索引 参数 与 sizer 的 Add() 列表 中 的 索引 相对 应 ， 这 个 
索引 在 grid bag 的 上 下 文中 没 多 大 意思 。 上 面 的 两 个 get 方法 都 有 对 应 

的 set 方法 ， SetItemPosition(window , pos) 和 SetItemSpan(window , 

span) ， 这 两 个 方法 的 第 一 个 参数 可 以 是 window , sizer ,或 index ， 第 二 个 
参数 是 一 个 Python 元 组 或 一 个 wx.GBPosition 或 wx.GBSpan 对 象 。 


什么 是 box 
sizer ? 


box sizer 是 wxPython 所 提供 的 sizer 中 的 最 简单 和 最 灵活 的 sizer 。 

一 个 box sizer 是 一 个 垂直 列 或 水 平行 ， 窗 口 部 件 在 其 中 从 左 至 右 或 从 上 到 下 
布置 在 一 条 线 上 。 虽 然 这 听 起 来 好 像 用 处 太 简 单 ， 但 是 来 自 相互 之 间 启 

套 sizer 的 能 力 使 你 能 够 在 每 行 或 每 列 很 容易 放置 不 同 数量 的 项 目 。 由 于 每 

个 sizer 都 是 一 个 独立 的 实体 ， 因 此 你 的 布局 就 有 了 更 多 的 灵活 性 。 对 于 大 多 数 
的 应 用 程序 ， 一 个 上 谋 套 有 水 平 sizer 的 垂直 sizer 将 使 你 能 够 创建 你 所 需要 的 
布局 。 


图 11.11-11.14 展 示 了 几 个 简单 的 box sizer 的 例子 。 图 中 所 展示 的 各 个 框架 我 
们 都 是 手动 调整 了 大 小 的 ， 以 便 展 示 每 个 sizer 是 如 何 响应 框架 的 增 大 的 。 图 
11.11 显 示 了 一 个 水 平 的 box sizer ， 图 11.12 在 一 个 垂直 的 box sizer 显示 
了 现 图 11.11 相 同 的 窗口 部 件 。 


图 11.11 
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Figure 11.11 A horizontal box sizer 


图 11.12 








Figure 11.12 
A vertical box sizer 
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AWj3ie5 f —^ 4E sizer ， 其 中 一 个 窗口 部 件 被 设置 成 可 扩展 并 填充 有 效 
的 重 直 空间 。 图 11.14 展 示 了 一 个 重 直 的 sizer ， 其 中 的 两 个 窗口 部 件 设置 为 按 不 
同 的 比例 占据 有 效 的 重 直 空间 。 


图 11.13 


Figure 11.13 

A vertical sizer 
with one stretch 
element 


els 1/3 of the free space 


gets 2/3 cf the free space Figure 11.14 
A vertical sizer 
with two stretch 
elements 


生成 以 上 四 个 sizer 框架 的 示例 代码 如 例 11.9 所 示 。 


例 11.9 产生 多 个 box sizer 











import wx 
from blockwindow import BlockWindow 
labels = "one two three four".split() 
class TestFrame(wx.Frame): 

title = "none" 


304 


def __init_ (self): 
wx.Frame.__init__(self, None, -1, self.title) 
sizer = self.CreateSizerAndWindows() 
self .SetSizer(sizer) 
self .Fit() 
class VBoxSizerFrame(TestFrame): 
title = "Vertical BoxSizer" 
def CreateSizerAndWindows(self): 
sizer = wx.BoxSizer(wx.VERTICAL) 
for label in labels: 
bw = BlockWindow(self, label=label, size=(200, 30) ) 
sizer .Add(bw, flag=wx.EXPAND) 
return sizer 
class HBoxSizerFrame(TestFrame) : 
title = "Horizontal BoxSizer" 
def CreateSizerAndWindows(self): 
sizer = wx.BoxSizer(wx.HORIZONTAL ) 
for label in labels: 
bw = BlockWindow(self, label-label, size-(75,30)) 
sizer .Add(bw, flag=wx.EXPAND) 
return sizer 
class VBoxSizerStretchableFrame(TestFrame) : 
title = "Stretchable BoxSizer" 
def CreateSizerAndWindows(self): 
sizer = wx.BoxSizer(wx.VERTICAL) 
for label in labels: 
bw = BlockWindow(self, label=label, size=(200, 30) ) 
sizer .Add(bw, flag=wx.EXPAND) 
# Add an item that takes all the free space 
bw = BlockWindow(self, label="gets all free space", size 
-(200,30)) 
sizer.Add(bw, 1, flag=wx.EXPAND) 
return sizer 
class VBoxSizerMultiProportionalFrame(TestFrame): 
title = "Proportional BoxSizer" 
def CreateSizerAndWindows(self): 
sizer - wx.BoxSizer(wx.VERTICAL) 
for label in labels: 
bw = BlockWindow(self, label-label, size=(200, 30) ) 
sizer .Add(bw, flag=wx.EXPAND) 
# Add an item that takes one share of the free space 
bw = BlockWindow(self, 
label="gets 1/3 of the free space", 
$ize=(200, 30) ) 
sizer .Add(bw, 1, flag=wx.EXPAND) 
# Add an item that takes 2 shares of the free space 
bw = BlockWindow(self, 
label="gets 2/3 of the free space", 
$ize=(200, 30) ) 
sizer .Add(bw, 2, flag=wx.EXPAND) 
return sizer 
app = wx.PySimpleApp( ) 
frameList = [VBoxSizerFrame, HBoxSizerFrame, 


VBoxSizerStretchableFrame, 
VBoxSizerMultiProportionalFrame] 
for klass in frameList: 
frame = klass() 
frame.Show() 
app.MainLoop() 


box sizer =X wx.BoxSizer 的 实例 ， wx.BoxSizer 是 wx.Sizer 的 子 
类 ， 相 对 于 wx.Sizer ^ wx.BoxSizer 几乎 没有 增加 新 的 方 
ik wx.BoxSizer 的 构造 函数 有 一 个 参数 : 


wx.BoxSizer (orient) 


参数 orient 代表 该 sizer 的 方向 ， 它 的 取 值 可 以 

是 WX.VERTICAL 或 wx.HORIZONTAL 。 对 于 box sizer 所 定义 的 唯一 一 个 新 
的 方法 是 GetOrientation() ， 它 返回 构造 函数 中 orient 的 整数 值 。 一 旦 一 
个 box sizer 被 创建 后 ， 你 就 不 能 改变 它 的 方向 了 。 box sizer WA Či $ 
数 使 用 本 章 早 先 所 讨论 的 一 般 的 sizer 的 方法 。 


box sizer 的 布局 算法 对 待 该 sizer 的 主 方向 ( 当 构 建 的 时 候 已 被 它 的 方向 
参数 所 定义 ) 和 次 要 方向 是 不 同 的 。 特 别 地 ， proportion 参数 只 适用 于 

当 sizer 沿 主 方向 伸缩 时 ， 而 wx.EXPAND 标记 仅 适 用 于 当 sizer 的 尺寸 在 次 方 
向 上 变化 时 。 换 名 话说 ， 当 一 个 王 直 的 box sizer 被 垂直 地 绘制 时 ， 传 递 给 每 
个 Add() 方法 调用 的 参数 proportion 决定 了 每 个 项 目 将 如 何 重 直 地 伸缩 。 除 了 
影响 sizer 和 它 的 项 目的 水 平 增 长 外 ， 参 数 proportion 以 同样 的 方式 影响 水 平 
的 box sizer 。 在 另 一 方面 ， 次 方向 的 增长 是 由 对 项 目 所 使 用 

的 wx.EXPAND 标记 来 控制 的 ， 所 以 ， 如 果 它 们 设置 了 wx. EXPAND 标记 的 话 ， 在 
一 个 垂直 的 box sizer 中 的 项 目 将 只 在 水 平方 向 增长 。 否 则 这 些 项 目 保持 它们 
的 最 小 或 最 合适 的 尺寸 。 图 6.7 演 示 了 这 个 过 程 。 


在 box sizer 中 ， 项 目的 比例 增长 类 似 于 flex grid sizer ， 但 有 一 些 例 
外 。 第 一 ，box sizer 的 比例 行为 是 在 窗口 部 件 被 添加 到 该 sizer 时 ， 使 

用 proportion 参数 被 确定 的 你 无 需 像 flex grid sizer 那样 单独 地 指 
定 它 的 增长 性 。 第 二 ， 比 例 为 0 的 行为 是 不 同 的 。 在 box sizer P > Obl ee 
着 该 窗口 部 件 在 主 方向 上 不 将 根据 它 的 最 小 或 最 合适 尺寸 被 调整 尺寸 ， 但 是 如 

果 wx.EXPAND 标记 被 使 用 了 的 话 ， 它 仍 可 以 在 次 方向 上 增长 。 当 box 

sizer 在 主 方 向 上 计算 它 的 项 目的 布局 时 ， 它 首先 合计 固定 尺寸 的 项 目 所 需要 的 
空间 ， 这 些 固定 尺寸 的 项 目 ， 它 们 的 比例 为 0。 余下 的 空间 按 项 目的 比例 分 配 。 





什么 是 static 
box sizer ? 


一 个 static box sizer 合并 了 box sizer 和 静态 框 ( static 
box ) * #AtE# sizer 的 周围 提供 了 一 个 漂亮 的 边框 和 文本 标签 。 图 11.15 显 
示 了 三 个 static box sizer ° 


Figure 11.15 
Three static box sizers 


例 11.10 显 示 了 产生 上 图 的 代码 。 这 里 有 三 个 值得 注意 的 事件 。 首 先 你 必须 单独 
于 sizer 创建 静态 框 对 象 ， 第 二 是 这 个 例子 展示 了 如 何 使 用 峙 套 的 box 
sizer 。 本 例 中 ， 三 个 垂直 的 static box sizer 被 放置 于 一 个 水 平 

的 box sizer T^» 








例 11.10 static box sizer 的 一 个 例子 


import wx 
from blockwindow import BlockWindow 
labels = "one two three four five six seven eight nine".split() 
class TestFrame(wx.Frame): 
def __ init (self): 
wx.Frame. init (self, None, -1, "StaticBoxSizer Test") 
self.panel - wx.Panel(self) 
# make three static boxes with windows positioned inside 


them 
box1 = self.MakeStaticBoxSizer("Box 1", labels[0:3]) 
box2 - self.MakeStaticBoxSizer("Box 2", labels[3:6]) 
box3 - self.MakeStaticBoxSizer("Box 3", labels[6:9]) 
4 We can also use a sizer to manage the placement of oth 
er 
# sizers (and therefore the windows and sub-sizers that 
they 


# manage as well.) 
sizer = wx.BoxSizer(wx.HORIZONTAL) 
sizer.Add(box1, 0, wx.ALL, 10) 
sizer.Add(box2, 0, wx.ALL, 10) 
sizer.Add(box3, 0, wx.ALL, 10) 
self.panel.SetSizer(sizer) 
sizer .Fit(self) 
def MakeStaticBoxSizer(self, boxlabel, itemlabels): 
# first the static box 
box = wx.StaticBox(self.panel, -1, boxlabel) 
# then the sizer 
sizer = wx.StaticBoxSizer(box, wx.VERTICAL) 
# then add items to it like normal 
for label in itemlabels: 
bw = BlockWindow(self.panel, label=label) 
sizer.Add(bw, 0, wx.ALL, 2) 

return sizer 

app = wx.PySimpleApp( ) 

TestFrame().Show( ) 

app .MainLoop( ) 


static box sizer 是 类 wx.StaticBoxSizer 的 实 
f|* wx.StaticBoxSizer Æ wx.BoxSizer 的 子 类 。 它 的 构造 函数 要 求 的 参数 是 
静态 框 和 方向 : 


wx.StaticBoxSizer(box , oient) 


在 这 个 构造 函数 中 ， orient 的 意义 与 原 wx.BoxSizer 相同 ， box 参数 是 一 
个 wx.StaticBox 。 对 于 static box sizer 所 定义 的 别 的 方法 只 有 一 
个 : GetStaticBox() ， 它 返回 用 于 建造 该 sizer 的 wx.StaticBox 。 一 旦 
该 sizer 被 创建 ， 那 么 你 就 不 能 再 改变 这 个 静态 框 了 。 


wx.StaticBox 类 有 一 个 用 于 wxPython 控件 的 标准 的 构造 函数 ， 但 是 其 中 许多 
参数 都 有 默认 值 ， 可 以 忽略 。 


wx.StaticBox(parent , id , label , pos = wx.DefaultPosition 
e size = wx.DefaultSize , style =0, name =" staticBox ") 


使 用 一 个 static box sizer ， 你 不 需要 去 设置 pos , size, style, 
或 name 参数 ， 因 为 位 置 和 尺寸 将 由 sizer 管理 ， 并 且 没 用 单独 用 
于 wx.StaticBox 的 样式 。 这 使 得 构造 更 简单 : 


box = wx.StaticBox(self.panel ,-1, boxlabel) 


到 目前 为 止 ， 我 们 已 经 展示 了 各 种 sizer ， 我 们 将 给 你 展示 如 何在 实际 的 布局 中 
使 用 它们 。 对 于 另外 一 个 用 于 创建 一 个 复杂 布局 的 例子 ， 请 参看 第 六 章 。 


一 个 现实 中 使 用 Sizer 的 例子 


迄今 为 止 ， 我 们 所 展示 的 有 关 sizer 的 例子 都 是 在 显示 它们 的 功能 方面 。 下 面 ， 
我 们 将 展示 一 个 如 何 使 用 sizer 来 建造 一 个 丰 实 的 布局 。 图 11.16 显 示 了 一 个 使 用 
不 同 sizer 建造 的 复杂 程度 适中 的 布局 。 


图 11.16 
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例 11.11 显 示 了 产生 上 图 的 代码 。 这 段 代码 看 起 来 有 点 复杂 ， 但 是 我 们 将 对 它 分 块 解 


读 。 


例 11.11 用 sizer 来 建造 地 址 表单 


#coding=utf -8 
#! python 
import wx 
class TestFrame(wx.Frame): 
def — init (self): 

wx.Frame. init (self, None, -1, "Real World Test") 

panel = wx.Panel(self) 

# First create the controls 

topLbl - wx.StaticText(panel, -1, "Account Information") 
#1 创建 窗口 部 件 

topLbl.SetFont(wx.Font(18, wx.SWISS, wx.NORMAL, wx .BOLD) 
) 


nameLbl = wx.StaticText(panel, -1, "Name:") 


name = wx.TextCtrl(panel, -1, ""); 

addrLbl = wx.StaticText(panel, -1, "Address:") 

addri = wx.TextCtrl(panel, -1, ""); 

addr2 = wx.TextCtrl(panel, -1, ""); 

cstLbl = wx.StaticText(panel, -1, "City, State, Zip:") 


city = wx.TextCtrl(panel, -1, "", size=(150,-1)); 
state = wx.TextCtrl(panel, -1, "", size=(50,-1)); 
zip = wx.TextCtrl(panel, -1, "", size=(70,-1)); 


phoneLbl = wx.StaticText(panel, -1, "Phone:") 
phone = wx.TextCtrl(panel, -1, ""); 
emailLbl = wx.StaticText(panel, -1, "Email:") 
email = wx.TextCtrl(panel, -1, ""); 
saveBtn = wx.Button(panel, -1, "Save") 
cancelBtn = wx.Button(panel, -1, "Cancel") 
# Now do the layout. 
# mainSizer is the top-level one that manages everything 
#2 重 直 的 Sizer 
mainSizer = wx.BoxSizer(wx.VERTICAL) 
mainSizer.Add(topLbl, 0, wx.ALL, 5) 
mainSizer.Add(wx.StaticLine(panel), 0, 
wx .EXPAND | wx . TOP|wx.BOTTOM, 5) 
# addrSizer is a grid that holds all of the address info 
43 地 址 列 
addrSizer = wx.FlexGridSizer(cols=2, hgap=5, vgap=5) 
addrSizer.AddGrowableCol(1) 
addrSizer.Add(nameLbl, 0, 
wx .ALIGN_RIGHT | wx .ALIGN_CENTER_VERTICAL ) 
addrSizer.Add(name, 0, wx.EXPAND) 
addrSizer.Add(addrLbl, 0, 
wx .ALIGN_RIGHT | wx.ALIGN_CENTER_VERTICAL ) 
addrSizer.Add(addri, 0, wx.EXPAND) 
#4 带 有 空白 空间 的 行 
addrSizer.Add((10,10)) # some empty space 
addrSizer.Add(addr2, 0, wx.EXPAND) 
addrSizer.Add(cstLbl, 0, 
WX.ALIGN RIGHT|wx.ALIGN CENTER VERTICAL) 
# the city, state, zip fields are in a sub-sizer 
#5 JOE E 
cstSizer = wx.BoxSizer(Wwx.HORIZONTAL) 
cstSizer.Add(city, 1) 
cstSizer.Add(state, 0, wx.LEFT|wx.RIGHT, 5) 
cstSizer.Add(zip) 
addrSizer.Add(cstSizer, 0, wx.EXPAND) 
H6 电话 和 电子 邮箱 
addrSizer.Add(phoneLbl, 0, 
wx .ALIGN_RIGHT | wx.ALIGN_CENTER_VERTICAL ) 
addrSizer.Add(phone, ©, wx.EXPAND) 
addrSizer.Add(emailLbl, 0, 
WX.ALIGN RIGHT|wx.ALIGN CENTER VERTICAL) 
addrSizer.Add(email, 0, wx.EXPAND) 
# now add the addrSizer to the mainSizer 
#7 添加 Flex sizer 
mainSizer.Add(addrSizer, 0, wx.EXPAND|wx.ALL, 10) 


# The buttons sizer will put them in a row with resizeab 
le 
# gaps between and on either side of the buttons 
48 按钮 行 
btnSizer = wx.BoxSizer(wx.HORIZONTAL) 
btnSizer .Add((20,20), 1) 
btnSizer .Add(saveBtn) 
btnSizer .Add((20,20), 1) 
btnSizer.Add(cancelBtn) 
btnSizer.Add((20,20), 1) 
mainSizer.Add(btnSizer, 0, wx.EXPAND|wx.BOTTOM, 10) 
panel.SetSizer(mainSizer) 
# Fit the frame to the needs of the sizer. The frame wi 
11 
# automatically resize the panel as needed. Also preven 
t the 
# frame from getting smaller than this size. 
mainSizer.Fit(self) 
mainSizer.SetSizeHints(self) 
app - wx.PySimpleApp() 
TestFrame().Show() 
app.MainLoop() 


#1 代码 的 第 一 部 分 是 创 DELE 口中 的 窗口 部 件 ， 它 们 在 这 行 开始 。 我 们 在 增 


加 sizer 前 将 它们 全 部 创建 


#2 在 这 个 布局 中 的 主 sizer 是 mainSizer ， 它 是 一 个 坚 直 的 box sizer 。 
被 添加 到 mainSizer 的 第 一 个 元 素 是 顶部 的 静态 文本 标签 和 一 个 static 
line ° 


#3 在 box sizer 中 接 下 来 的 元 素 是 addrSizer ， 它 是 一 个 flex grid 
sizer ， 它 有 两 列 ， 它 两 列 用 于 容纳 其 余 的 地 址 信息 。 addrSizer 的 左 列 被 设 
计 用 于 静态 文本 标签 ， Ws i 到 xd 件 。 这 意味 着 标签 和 控件 需要 被 交替 
的 添加 ， 以 保证 grid 的 正确 。 你 可 以 看 到 nameLbl , name , addrLbl , 

和 addri 是 首先 被 添加 到 该 flex grid 中 的 四 个 元 素 。 


#4 这 接 下 来 的 行 是 不 同 的 ， 因 为 这 第 二 个 地 址 行 没有 标签 ， 一 个 (10,10) 尺 寸 的 空 
白 块 被 添加 ， 然 后 是 addr2 控 he 


#5 接 下 来 的 行 又 有 所 不 同 ， 包 括 * City, State , zip "的 行 要 求 三 个 不 同 的 文 
an 件 ， 基 于 这 种 情况 ， 我 们 创 VR CS box sizer : cstSizer ° X 
个 控件 被 添加 给 cstSizer ， 然 后 这 个 box sizer 被 添加 到 addrSizer 。 


#6 电话 和 电子 邮箱 行 被 添加 到 Flex sizer ° 
#7 有 关 地 址 的 flex sizer 被 正式 添加 到 主 sizer © 
#8 按钮 行 作为 水 平 box sizer 被 添加 ， 其 中 有 一 些 空白 元 素 以 分 隔 按钮 。 


在 调整 了 sizer ( mainSizer.Fit(self) ) 和 防止 框架 变 得 更 小 之 后 
( mainSizer.SetSizeHints(self) ) ， 元 素 的 布局 就 结束 了 。 


在 读 这 接 下 来 的 段落 或 运行 这 个 例子 之 前 ， 请 试 着 想 出 该 框架 将 会 如 何在 水 平和 坚 
直方 向 上 响应 增长 。 


如 果 该 窗口 在 坚 直方 向 上 的 大 小 改变 了 ， 其 中 的 元 素 不 会 移动 。 这 是 因为 

i sizer 是 一 个 重 直 的 box sizer ， 你 是 在 它 的 主 方向 上 改变 尺寸 ， 它 没有 
一 个 顶级 元 素 是 以 大 于 0 的 比 列 被 添加 的 。 如 果 这 个 窗口 在 水 平方 向 被 调整 尺寸 ， 
由 于 这 个 主 sizer 是 一 个 垂直 的 box sizer ， 你 是 在 它 的 次 方向 改变 尺寸 ， 
因此 它 的 所 有 有 wx ,EXPAND 标记 的 元 素 将 水 平 的 伸展 。 这 意味 着 顶部 的 标签 不 增 
长 ， 但 是 static line fe sizer 将 水 平 的 增长 。 用 于 地 址 的 flex grid 
sizer 指定 列 1 是 可 增长 的 ， 这 意味 着 包含 文本 控件 的 第 二 列 将 增长 。 在 * City ， 
State , Zip “行内 ， 比 列 为 1 的 city 元 素 将 伸展 ， 而 state 和 ZIP 控件 将 
保持 尺寸 不 变 。 按 钮 将 保持 原 有 的 尺寸 ， 因 为 它们 的 比 列 是 0， 但 是 按钮 所 在 行 的 
空白 空间 将 等 分 地 占据 剩 下 的 空间 ， 因 为 它们 每 个 的 比 列 都 是 1。 


因此 如 果 你 想 出 的 窗口 伸展 的 样子 和 下 图 11.17 相 同 ， 那 么 你 是 正确 的 。 
图 11.17 
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Figure 11.17 The account information, after the window was stretched 


本 章 小 结 


1^ Sizer 是 对 wxPython 程序 中 管理 布局 问题 的 解决 方法 。 不 用 手动 指定 每 个 
元 素 在 布局 中 的 位 置 和 尺寸 ， 你 可 以 将 元 素 添加 到 一 个 sizer 中 ， 由 sizer 负 
责 将 每 个 元 素 放 置 到 屏幕 上 。 当 用 户 调整 框架 的 尺寸 时 ， sizer 管理 布局 是 相当 
好 的 。 


2、 所 有 的 wxPython 的 sizer 都 是 类 wx.Sizer 的 一 个 子 类 的 实例 。 要 使 用 一 
sizer ， 你 需要 把 它 与 一 个 容器 型 的 窗口 部 件 关联 起 来 。 然 后 ， 对 于 要 添加 到 
容器 中 的 子 窗口 部 件 ， 你 也 必需 将 它们 添加 到 该 sizer 。 最 后 ， 调 用 
该 sizer 的 Fit() 方法 来 触发 该 sizer 的 算法 ， 以 便 布 局 和 放置 。 


3、 所 有 的 sizer 开始 都 给 它们 的 孩子 以 最 小 的 尺寸 。 每 种 sizer 各 自 使 用 不 同 
的 机 制 来 放置 窗口 部 件 ， 所 以 相同 组 的 窗口 部 件 放置 在 不 同 的 sizer 中 时 ， 它 们 
的 外 观 也 是 不 同 的 。 


4、 或 许 在 wxPython 中 ， 最 简单 的 sizer 是 grid  sizer(wx.GridSizer) ° 
在 grid sizer 中 ， 元 素 按照 它们 被 添加 给 sizer 的 顺序 被 放置 在 一 个 二 维 的 
网 格 中 ， 按 照 从 左 到 右 ， 从 上 到 下 的 方式 排列 。 通 常 你 负责 设 定 列 数 ， sizer 确 
定 行 数 。 你 能 够 同时 指定 行 和 列 ， 如 果 你 愿意 的 话 。 


5、 所 有 的 sizer 都 有 各 自 不 同 的 用 来 将 窗口 部 件 添 加 到 sizer 的 方法 。 由 于 窗 
口 部 件 添 加 到 sizer 中 的 顺序 对 于 最 后 的 布局 是 重要 的 ， 所 以 有 不 同 的 方法 用 来 
添加 一 个 新 的 窗口 部 件 到 列表 中 的 前 面 、 后 面 或 任意 点 。 在 一 个 窗口 部 件 被 添加 
到 sizer 时 ， 另 外 的 属性 可 以 被 设置 ， 它 们 控制 当 sizer 增 减 时 ， 其 中 的 子 元 
素 如 何 变 化 。 sizer 也 能 够 被 配置 来 在 对 象 的 某 些 或 全 部 边 上 放置 一 个 边界 间 
FR o 


第 十 二 齐 操作 基本 图 像 


1. 处 理 基 本 的 图 像 
ij， 使 用 图 像 工 作 
ij， 如何 载 入 图 像 ? 
i， 我 们 能 够 对 图 像 作 些 什 么 ? 


REAR: 


e 装载 图 像 和 创建 图 像 对 象 
e 创建 设备 上 下 文 

e 绘制 到 设备 上 下 文 

e 绘制 文本 到 设备 上 下 文 

e 管理 画 刷 、 画 笔 和 设备 坐标 


任何 用 户 界面 工具 的 最 基本 的 行为 就 是 在 屏幕 上 绘制 。 在 最 基本 的 层面 上 来 说 ， 定 
义 在 wxPython 中 的 每 个 窗口 部 件 都 是 由 发 送 给 屏幕 的 一 系列 命令 构成 的 。 那 些 绘 
制 命令 是 否 是 在 wxPython 代码 库 中 ， 这 依赖 于 相关 窗口 部 件 对 于 本 地 操作 系统 是 
否 是 本 地 化 的 或 完全 由 wxPython 所 定义 的 。 在 这 一 章 ， 我 们 将 给 你 展示 如 何在 基 
本 绘制 命令 层面 上 控制 wxPython 。 我 们 也 将 给 你 展示 如 何 管理 和 显示 其 它 的 图 形 
化 元 素 如 图 像 和 字体 。 


被 wxPython 用 于 绘制 的 主要 的 概念 是 设备 上 下 文 ( device context ) 。 设 备 
上 下 文 使 用 一 个 标准 的 API 来 管理 对 设备 (如 屏幕 或 打印 机 ) 的 绘制 。 设 备 上 下 
文 类 用 于 最 基本 的 绘制 功能 ， 如 绘制 一 条 直线 、 曲 线 或 文本 。 


使 用 图 像 工 作 


大 多 数 的 应 用 程序 都 需要 载 入 至 少 一 个 图 像 ， 这 些 图 像 存 储 在 外 部 的 文件 中 。 样 例 
包括 工具 栏 图 片 、 光 标 、 图 标 、 启 始 画 面 或 仅仅 用 于 装饰 以 增加 一 些 时 旷 感 的 图 
像 。 传 统 上 ， 使 用 图 像 工作 的 复杂 性 是 不 得 不 处 理 用 于 储存 图 像 的 不 同 的 图 片 文件 
格式 。 幸 运 的 是 ， wxPython 内 部 为 你 做 了 所 有 的 这 些 。 你 将 使 用 相同 的 抽象 概念 
来 处 理 任何 图 像 ， 而 不 用 关心 它 的 原始 格式 。 


在 随后 的 几 节 中 ， 我 们 将 讨论 wxPython 用 来 管理 图 像 的 那么 抽象 概念 ， 这 包括 大 
尺寸 图 像 ( large - scale images) ， 以 及 光标 图 像 。 你 将 看 到 如 何 装 载 图 像 到 你 
的 程序 中 ， 然 后 如 何 操作 它们 。 


如 何 载 入 图 像 ? 


在 wxPython 中 ， 图 像 处 理 是 一 个 双 主 管 系统 ， 与 平台 无 关 的 图 像 处 理由 
类 wx.Image 管理 ， 而 与 平台 有 关 的 图 像 处 理由 类 wx.Bitmap 管理 。 实 际 上 ， 意 
思 就 是 外 部 文件 格式 由 wx.Image 装载 和 保存 ， 而 wx.Bitmap 负责 将 图 像 显 示 到 
屏幕 。 图 12.1 显 示 了 不 同 图 像 和 位 图 的 创建 ， 按 照 不 同 的 文件 类 型 读 入 。 





要 从 一 个 文件 载 入 一 个 图 像 ， 使 用 wx. Image 494938 HH: 


wx.Image(name, type=wx.BITMAP_TYPE_ANY, index=-1) 


Figure 12.1 
Big and little images 
of different types 


参数 name 是 图 像 文件 的 名 字 ， 参 数 type (XA) 是 处 理 器 类 

型 。 type 的 ID 可 以 是 wx.BITMAP_TYPE_ANY 或 表 12.1 中 的 一 个 。 如 果 你 使 
用 wx.BITMAP TYPE ANY * Jf A wxPython 将 试图 自动 检测 该 文件 的 类 型 。 如 果 
你 使 用 一 个 特定 的 文件 类 型 ， 那 么 wxPython 将 使 用 该 类 型 转换 这 个 文件 。 例 12.1 
显示 了 如 何 使 用 wx,BITMAP_TYPE_ANY 来 载 入 图 像 。 


例 12.1 载 入 并 缩放 简单 图 像 








import wx 


filenames = ["image.bmp", "image.gif", "image.jpg", "image.png" 


] 


class TestFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init__(self, None, title="Loading Images") 
p = wx.Panel(self) 


fgs - wx.FlexGridSizer(cols-2, hgap-10, vgap-10) 
for name in filenames: 

#1 从 文件 载 入 图 像 

imgi = wx.Image(name, wx.BITMAP TYPE ANY) 


imgi.GetWidth() 
= imgi.GetHeight() 
img2 = imgi.Scale(w/2, h/2)#2 缩小 图 像 


Scale the oiginal to another wx.Image 


H3 转换 它们 为 静态 位 图 部 件 
sb1 = wx.StaticBitmap(p, -1, wx.BitmapFromImage(imgi 


sb2 = wx.StaticBitmap(p, -1, wx.BitmapFromImage(img2 


# and put them into the sizer 
fgs.Add(sb1) 
fgs.Add(sb2) 


p.SetSizerAndFit(fgs) 
self.Fit() 


app - wx.PySimpleApp() 
frm = TestFrame() 
frm.Show() 
app.MainLoop() 


上 面 的 代码 应 该 很 简单 。 代 码 开始 是 我 们 想 要 载 入 的 图 像 文 件 的 名 字 ， 我 们 使 
用 wx.BITMAP TYPE ANY 类 型 标记 指示 wxPython 去 断定 图 像 文 件 的 格式 ， 而 用 
不 着 我 们 操心 。 然 后 我 们 使 用 图 像 的 方法 将 图 像 缩 小 一 半 ， 并 将 图 像 转换 为 位 图 。 


你 也 可 以 显示 地 指定 图 像 文件 的 格式 ， 在 下 一 节 ， 我 们 将 显示 wxPython 所 支持 的 
图 像 文件 格式 。 


指定 一 个 图 像 文件 格式 


图 像 由 所 用 的 图 像 处 理 器 管理 。 一 个 图 像 处 理 器 是 wx.ImageHandler 的 一 个 实 
例 ， 它 为 管理 图 像 格式 提供 了 一 个 插入 式 的 结构 。 在 通常 的 情况 下 ， 你 不 需要 考虑 
图 像 处 理 器 是 如 何 工作 的 。 你 所 需要 知道 的 是 每 个 处 理 器 都 有 它 自己 唯一 


的 wxPython 标识 符 ， 


处 理 器 类 


wx.ANIHandler 


wx. BMPHandler 


wx.CURHandle 


wx.GIFHandler 


wx.ICOHandler 


wx.IFFHandler 


wx.JPEGHandler 


wx.PCXHandler 


wx.PNGHandler 


wx.PNMHandler 


wx.TIFFHandler 


wx.XPMHandler 


自动 


用 以 载 入 相关 格式 的 文件 。 表 12.1 列 出 了 所 支持 的 格式 。 
表 12.1 wxPython 支持 的 图 像 文 件 格式 


WX . 


WX . 


WX . 


WX. 


WX. 


WX 


WX 


WX. 


WX. 


WX. 


WX. 


WX 


WX 


类 型 标记 


BITMAP_TYPE_ANI 


BITMAP_TYPE_BMP 


BITMAP_TYPE_CUR 


BITMAP_TYPE_GIF 


BITMAP_TYPE_ICO 


BiMAPSINRES LEE 


.BITMAP TYPE JPEG 


BITMAP TYPE PCX 


BITMAP TYPE PNG 


BITMAP TYPE PNM 


BITMAP TYPE TIF 


.BITMAP TYPE XPM 


.BITMAP TYPE ANY 


说 明 


动画 光标 格式 。 这 个 处 理 器 
只 载 入 图 像 而 不 保存 它们 。 


Windows 和 0S /2 位 图 格 
ru 


Windows 光标 图 标 格 
X o 


图 形 交 换 格式 。 由 于 版 权限 
制 ， 这 个 处 理 器 不 保存 图 
像 。 


Windows 图 标 格 式 。 


交换 文 作 格 二 全 区 个 处理 这 
RBA BR? ETRAS 
as 


联合 图 形 专家 组 格式 。 


PC 画 刷 格式 。 当 以 这 种 
格式 保存 

时 ， wxPython 计算 在 这 
个 图 像 中 的 不 同 颜色 的 数 
量 。 如 果 可 能 的 话 ， 这 个 图 
像 被 保存 为 一 个 8 位 图 像 
(也 就 是 说 ， 如 果 它 有 256 
种 或 更 少 的 颜色 ) GUE 
保存 为 24 位 。 


便携 式 网 络 图 形 格 式 。 


RIERA ASCII 或 原始 
的 RGB 图 像 。 图 像 被 该 处 
理 器 保存 为 原始 的 RGB 。 


标签 图 像 文件 格式 。 
XPixMap 格式 。 


自动 检测 使 用 的 格式 ， 然 后 
调用 相应 的 处 理 器 。 


要 使 用 一 个 MIME 类 型 来 标识 文件 ， 而 不 是 一 个 处 理 器 类 型 ID HB HRA A 

数 wx.ImageFromMime(name, mimetype, index =-1)， 其 中 的 name 是 文件 

名 ，mimetype 是 有 关 文 件 类 型 的 字符 串 。 参 数 index 表示 在 图 像 文 件 包 含 多 个 
图 像 的 情况 下 要 载 入 的 图 像 的 索引 。 这 仅仅 被 GIF, ICO, fe TIFF 处 理 器 使 用 。 
默认 值 -1 表示 选择 默认 的 图 像 ， 被 GIF 和 TIFF 处 理 顺 解释 为 每 一 个 图 像 

( index =0) ， 被 rco 处 理 器 解释 为 最 大 且 最 多 色彩 的 一 个 。 


创建 image (图 像 ) 对 象 


wxPython 使 用 不 同 的 全 局 函数 来 创建 不 同 种 类 的 wx.Image 对 象 。 要 创建 一 个 
有 着 特定 尺寸 的 空 图 像 ， 使 用 函数 wx.EmptyImage(width,height) 一 一 在 这 个 
被 创建 的 图 像 中 所 有 的 像素 都 是 黑色 。 要 创建 从 一 个 打开 的 流 或 Python 文件 类 对 
象 创建 一 个 图 像 ， 使 
用 wx.ImageFromStream(stream,type = wx.BITMAP TYPE ANY, index =-1) ° 
有 时， 根据 一 个 原始 的 RGB 数据 来 创建 一 个 图 像 是 有 用 的 ， 这 使 
用 wx.ImageFromData(width,height,data) > data 是 一 个 字符 串 ， 每 套 连 续 
的 三 个 字符 代表 一 个 像素 的 红 ， 绿 ， 蓝 的 组 分 。 这 个 字符 串 的 大 小 应 该 


日 


是 width height 3。 
创建 bitmap (位 图 ) HR 


有 几 个 方法 可 以 创建 一 个 位 图 对 象 。 其 中 最 基本 的 wx.Bitmap 构造 函数 是 
wx.Bitmap(name, type = wx.BITMAP_TYPE_ANY) 。 参 数 name 是 一 个 文件 
名 ，type 可 以 是 表 12.1 中 的 一 个 。 如 果 bitmap 类 能 够 本 地 化 地 处 理 这 个 文件 
格式 ， 那 么 它 就 处 理 ， 否 则 这 个 图 像 将 自动 地 经 由 wx.Image 载 入 并 被 转换 为 一 

个 wx.Bitmap 实例 。 


你 可 以 使 用 方法 wx.EmptyBitmap(width,height,depth =-1) 来 创建 一 个 空 的 位 

图 参数 width 和 height 是 位 图 的 尺度 ， depth 是 结果 图 像 的 颜色 深度 。 

有 两 个 函数 使 你 能 够 根据 原始 的 数据 来 创建 一 个 位 图 。 函 

数 wx.BitmapFromBits(bits, width, height, depth =-1) 创 建 一 个 位 图 ， 参 

数 bits 是 一 个 Python 字 节 列表 。 这 个 函数 的 行为 依赖 于 平台 。 在 大 多 数 平台 

上 ， bits 要 么 是 1 要 么 是 0， 并 且 这 个 函数 创建 一 个 单 色 的 位 图 。 在 windows # 
台 上 ， 数 据 被 直接 传递 给 Windows 的 API “3k CreateBitmap() ° & 

数 wxBitmapFromxPMData(listOfStrings) 一 个 Python 字符 串 列 表 作 为 一 个 

参数 ， 以 XPM 格式 读 该 字符 串 。 





通过 使 用 wx.Bitmap 的 构造 函数 wx.BitmapFromImage(image, depth =-1)， 你 
可 以 将 一 个 图 像 转换 为 一 个 位 图 。 参 数 image 是 一 个 实际 wx.Image 对 

KR? depth 是 结果 位 图 的 颜色 深度 。 如 果 这 个 深度 没有 指定 ， 那 么 使 用 当前 显示 
器 的 颜色 深度 。 你 可 以 使 用 函数 wx.ImageFromBitmap(bitmap) 将 位 图 转 回 为 一 
个 图 像 ， 通 过 传递 一 个 实际 的 wx.Bitmap 对 象 。 在 例 12.1 中 ， 位 图 对 象 的 创建 使 
用 了 位 图 的 构造 函数 ， 然 后 被 用 于 构建 wx.StaticBitmap 窗口 部 件 ， 这 使 得 它们 
能 够 像 别 的 wxPython 项 目 一 样 被 放 入 一 个 容器 部 件 中 。 


我 们 能 够 对 图 像 作 些 什么 ? 


一 旦 你 在 wxPython 中 使 用 了 图 像 ， 你 就 可 以 使 用 许多 有 用 的 方法 来 处 理 它 ， 并 且 
可 以 写 一 些 强 大 的 图 像 处 理 脚本 。 


你 可 以 使 用 Getwidth() 和 GetHeight() 方法 来 查询 图 像 的 尺寸 。 你 也 可 以 使 用 
方法 GetRed(x, y), GetGreen(x, y), f» GetBlue(x, y) 方法 得 到 任意 象 素 
点 的 颜色 值 。 这 些 颜 色 方 法 的 返回 值 是 一 个 位 于 0~255 之 间 的 整数 〈 用 C 的 术语 ， 
它 是 一 个 无 符号 整数 ， 但 是 这 个 区 别 在 Python 中 没有 多 大 的 意义 ) 。 同 样 ， 你 能 
够 使 用 SetRGB(x, y, red, green, blue) 来 设置 一 个 像素 点 的 颜色 ， 其 中 的 X 
和 Vy 是 这 个 像素 点 的 坐标 ， 顾 色 的 取 值 位 于 0~255 之 间 。 


你 可 以 使 用 GetData() 方法 得 到 一 大 块 区 域 中 的 所 有 数据 。 GetData() 方法 的 
返回 值 是 一 个 大 的 字符 串 ， 其 中 的 每 个 字符 代表 一 个 RGB 元 组 ， 并 且 每 个 字符 都 
可 被 认为 是 一 个 0~255 之 间 整 数值 。 这 些 值 是 有 顺序 的 ， 第 一 个 是 位 于 像素 点 (0,0) 
的 红色 值 ， 接 下 来 的 是 位 于 像素 点 (0,0) 的 绿色 值 ， 然 后 是 位 于 像素 点 (0,0) 的 蓝 色 
值 。 再 接 下 来 的 三 个 是 像素 点 (0,1) 的 颜色 值 ， 如 此 等 等 。 这 个 算法 可 以 使 用 下 面 
的 Python 伪 代 码 来 定义 : 


def GetData(self): 

result = "" 

for y in range(self.GetHeight()): 

for x in range(self.GetWidth()): 
result.append(chr(self.GetRed(x,y))) 
result.append(chr(self.GetGreen(x, y))) 
result.append(chr(self.GetBlue(x,y))) 
return result 


当 使 用 对 应 的 SetData(data) 方法 读 取 类 似 格 式 的 RGB 字符 串 值 时 ， 有 两 件 事 
需要 知道 。 第 一 ， SetData(data) 方法 不 执行 范围 或 边界 检查 ， 以 确定 你 读 入 的 
字符 串 的 值 是 否 在 正确 的 范围 内 或 它 的 长 度 是 否 是 给 定 图 像 的 尺寸 。 如 果 你 的 值 不 
正确 ， 那 么 该 行为 是 未 定义 的 。 第 二 ， 由 于 底层 是 C++ 代码 管理 内 在 ， 所 以 

将 GetData() 的 返回 值 传递 给 SetData() 是 一 个 坏 的 方法 你 应 该 构造 一 个 
新 的 字符 串 。 


图 像 数据 字符 串 可 以 很 容易 地 与 别 的 Python 类 型 作 相 互 的 转换 ， 这 使 得 很 容易 以 
整数 的 形式 来 访问 和 处 理 它 ， 诸 如 数组 或 数字 类 型 。 例 如 ， 如 果 你 太 久 的 注视 一 个 
东西 会 损伤 眼睛 一 样 ， 试 试 这 样 : 





import array 

img = wx.EmptyImage(100, 100) 

a = array.array('B', img.GetData()) 
for i in range(len(a)): 

a[i] = (25+i) % 256 
img.SetData(a.tostring()) 


表 12.2 定 义 了 一 些 wx.Image 的 方法 ， 这 些 方法 执行 简单 的 图 像 处 理 。 


这 些 方法 只 是 图 像 处 理 的 开始 部 分 。 在 接 下 来 的 部 分 ， 我 们 将 给 你 展示 两 个 方法 ， 
它们 处 理 透 明和 半 透 明 图 像 这 一 更 复杂 的 主题 。 


表 12.2 wx.Image 的 图 像 处 理 方 法 


ConvertToMono(r, g, b) :返回 一 个 与 原 尺 寸 一 致 的 wx.Image > LP HAR 
色 值 为 ( r, g, b) 的 像素 颜色 改 为 白色 ， 其 余 为 黑色 。 原 图 像 未 改变 。 


Mirror(horizontally = True) : 返回 原 图 像 的 一 个 镜像 图 像 。 如 
果 horizontally 参数 是 True ， 那 么 镜像 图 像 是 水 平 翻 转 了 的 ， 否 则 是 垂直 翻 
转 了 的 。 原 图 像 没有 改变 。 


Replace(ri, gi, bi, r2, g2, b2) : 改变 调用 该 方法 的 图 像 的 所 有 颜色 值 
A ri, gi, bi 的 像素 的 颜色 为 r2, g2, b2 。 


Rescale(width, height) : 改变 图 像 的 尺寸 为 新 的 宽度 和 高 度 。 原 图 像 也 作 了 
改变 ， 并 且 颜 色 按 比 例 地 调整 到 新 的 尺寸 。 


Rotate(angle, rotationCentre, interpolating = True, offestAfterRota 
= None) : 返回 旋转 原 图 像 后 的 一 个 新 的 图 像 。 参 数 angle 是 一 个 浮 点 数 ， 代 表 
所 转 的 弧度 。 rotationCentre 是 一 个 wx.Point ， 代 表 旋 转 的 中 心 。 如 
果 interpolating 为 True ， 那 么 一 个 较 慢 而 精确 的 算法 被 使 
Fle offsetAfterRotation 是 一 个 坐标 点 ， 表 明 在 旋转 后 图 像 应 该 移 位 多 少 。 任 
何 未 被 覆盖 的 空白 像素 将 被 设置 为 黑色 ， 或 如 果 该 图 像 有 一 个 让 音色 ， 设 置 为 庶 单 
色 ( mask color ) ° 


Rotate90(clockwise = True) : 按照 参数 clockwise 的 布尔 值 ， 控 制图 像 按 
顺 或 北 时 针 方 向 作 90 度 的 旋转 。 


Scale(width, height) :返回 一 个 原 图 像 的 拷贝 ， 并 按 比 例 改变 为 新 的 宽度 和 
高 度 。 


设置 图 像 的 让 章 以 指定 一 个 延明 的 图 像 


图 像 遮 章 是 图 像 中 的 一 个 特殊 的 颜色 集 ， 当 图 像 显 示 在 其 它 显 示 部 分 之 上 时 ， 它 扮 
演 透 明度 的 角色 。 你 可 以 使 用 SetMaskColor(red, green, blue) 方法 来 设置 一 
ARIK BS > PAD red, green, blue 定义 图 像 遮 覃 的 颜色 。 如 果 你 想 关 闭 遮 
单 ， 可 以 使 用 SetMask(False) ， 重 置 使 用 SetMask(True) 。 方 

法 HasMask() 返回 与 当前 庶 畦 状态 相关 的 一 个 布尔 值 。 你 也 可 以 使 用 方 

法 SetMaskFromImage(mask, mr, mg, mb) 根据 同一 尺寸 的 另 一 图 像 设 置 遮 音 
一 在 这 种 情况 下 ， 遮 章 被 定义 为 在 遮 单 wx.Image 中 有 着 颜色 mr, mg, mb 的 
所 有 像素 ， 而 不 管 在 主 图 像 中 那些 像素 是 什么 颜色 。 这 使 得 你 在 创建 一 个 遮 罩 中 有 
了 很 大 的 灵活 性 ， 因 为 你 不 必 再 担心 在 你 原 图 像 中 的 像素 的 颜色 。 你 可 以 使 

用 GetMaskRed() * GetMaskGreen()， 和 GetMaskBlue() PRŞ É o» du 
— ^p 3& XE ARR RA + wx.Bitmap > PARBRA zd 4&2; — 

个 wx.Mask 对 象 并 赋 给 该 位 图 。 


设置 alpha 值 来 指定 一 个 透明 的 图 像 


alpha 值 是 指定 一 个 透明 或 部 分 透明 图 像 的 另 一 个 方法 。 每 个 像素 都 有 一 

个 alpha 值 ， 取 值 位 于 0 (如 果 图 像 在 该 像素 是 完全 透明 的 ) 到 255 (如 果 图 像 在 
该 像素 点 是 完全 不 透明 的 ) 之 间 。 你 可 以 使 用 SetAlphaData(data) 方法 来 设 

置 alpha 值 ， 它 要 求 类 似 于 SetData() 的 字符 串 字 节 值 ， 但 是 每 个 像素 只 有 一 

个 值 。 和 SetData() 一 样 ， SetAlphaData() 不 进行 范围 检查 。 你 可 以 使 

用 HasAlpha() 来 看 是 否 设 置 了 alpha 值 ， 你 也 可 以 使 用 GetAlphaData() 来 

得 到 全 部 的 数据 集 。 你 也 可 以 使 用 SetAlpha(x, y, alpha) 来 设 定 一 个 特定 的 像 
素 的 alpha 值 ， 并 使 用 GetAlpha(x, y) 来 得 到 该 值 。 


与 wx.Image 的 图 像 处 理 功能 相对 照 ， wx.Bitmap 的 相对 少 些 。 几 乎 所 
有 wx.Bitmap 的 方法 都 是 简单 得 得 到 诸如 宽度 、 高 度 和 闫 色 深度 这 类 的 属性 。 


Fe 


第 三 部 分 高 级 wxPython 


在 这 一 部 分 ， 我 们 以 三 个 更 复杂 的 窗口 部 件 对 象 作为 开始 ， 并 转 到 并 不 是 每 
个 wxPython 程序 都 有 的 特性 上 来 。 


在 第 13 章 “建造 列表 控件 并 管理 项 目 " 中 ， 我 们 涉及 到 了 列表 控件 。 较 简单 的 列表 框 
更 为 高 级 的 是 ， 这 个 列表 控件 可 以 用 来 产生 一 个 十 分 类 似 于 Windows 资源 管理 器 
的 东西 ， 包 括 不 同 的 模式 。 你 将 看 到 如 何在 模式 间 进 行 切换 ， 添 加 文本 和 图 像 到 列 
表 ， 还 有 响应 用 户 事件 。 


14 章 “协调 grid 控件 "为 列表 增加 了 grid 控件 。 grid 是 十 分 灵活 的 ， 我 们 将 给 
你 展示 管理 网 格 中 数据 的 所 有 方法 ， 以 及 自 定义 网 格 显示 和 编辑 的 机 制 。 


第 15 章 “ 树 形 控件 "处 理 树 形 控 件 ， 它 使 你 能 够 显示 树 的 层次 。 我 们 将 展示 如 何 管理 
树 的 数据 ， 人 遍历 树 和 自 定义 树 的 显示 。 


在 第 16 章 “在 你 的 应 用 程序 中 加 入 HTML ”中 ， 我 们 将 展示 用 HTML 来 指定 文本 标签 
和 打印 的 样式 是 多 么 的 便利 。 我 们 将 给 你 展示 HTML 窗口 部 件 是 如 何 工 作 的 ， 以 及 
它们 关于 标准 HTML 的 局 限 性 。 


第 17 章 ″ wxPython 的 打印 框架 ”涉及 到 了 打印 ， 如 何 绘制 到 一 个 打印 机 ， 以 及 如 何 
管理 在 wxPython 和 底层 打印 系统 间 通 信 的 标准 打印 对 话 框 。 我 们 也 将 展示 如 何 添 
加 打印 预览 功能 。 


第 18 章 “使 用 wxPython 的 其 它 功能 "所 涉及 的 东西 不 是 无 论 哪 都 适用 。 这 章 涉 及 了 
通过 剪贴 板 传递 数据 以 及 如 何 管理 拖 放 操 作 等 方面 。 我 们 还 将 展示 如 何 使 用 计时 器 
( timer) 创建 定时 的 行为 ， 并 提供 少量 在 wxPython 应 用 程序 中 关于 线程 方面 的 
想法 。 


第 十 三 章 建造 列表 控件 并 管理 列表 项 


e 创建 不 同样 式 的 列表 控件 
e 处 理 列表 中 的 项 目 

e 响应 列表 中 用 户 的 选择 
e 编辑 标签 和 对 列表 排序 
e 创建 大 的 列表 控件 


在 wxPython 中 ， 有 两 个 控件 ， 你 可 以 用 来 显示 基于 列表 的 信息 。 较 简单 的 是 列表 
框 ， 它 是 可 滚动 的 单列 列表 ， 类 似 于 使 用 HTML 的 select dr |] 的。 列表 
框 已 经 在 第 8 章 中 讨论 过 了 ， 本 章 不 再 作 进 一 步 的 讨论 。 


本 章 讨论 较为 复杂 的 列表 : 列表 控件 ， 它 是 一 个 完整 特性 的 列表 窗口 部 件 。 这 个 列 


表 控 件 可 以 每 行 显示 多 列 信息 ， 并 可 基于 任 一 行进 行 排序 ， 还 能 以 不 同 的 样式 显 
示 。 对 于 列表 控件 的 每 个 部 分 的 细节 显示 ， 你 有 很 大 的 灵活 性 。 


建造 一 个 列表 控件 


列表 控件 能 够 以 下 面 四 种 不 同 模式 建造 : 
e 图 标 ( icon) 
e 小 图 标 ( small icon) 
e。 列 表 ( list) 
e 报告 ( report) 


如 果 你 用 过 微软 Windows $( Explorer) 或 Mac 的 Finder ， 那 么 
这 些 方式 你 应 该 熟悉 。 我 们 将 通过 说 明 如 何 建立 四 种 不 同 模式 的 列表 作为 开始 来 介 
绍 列表 控件 。 


什么 是 图 标 模式 ? 


列表 控件 看 起 来 类 似 于 微软 的 windows 资源 管理 器 的 一 个 文件 树 系统 的 显示 面 
板 。 它 以 四 种 模式 之 一 的 一 种 显示 一 个 信息 的 列表 。 默 认 模 式 是 图 标 模式 ， 显 示 在 
列表 中 的 每 个 元 素 都 是 一 个 其 下 带 有 文本 的 一 个 图 标 。 图 13.1 显 示 了 一 个 图 标 模式 
的 列表 。 


例 13.1 是 产生 图 13.1 的 代码 。 注 意 这 个 例子 使 用 了 同 目录 下 的 一 些 . png 文件 。 
例 13.1 创建 一 个 图 标 模 式 的 列表 


#-*- encoding:UTF-8 -*- 
import wx 
import sys, glob 


class DemoFrame(wx.Frame): 
def — init (self): 
wx.Frame. init (self, None, -1, 
"wx.ListCtrl in wx.LC ICON mode", 
size-(600,400)) 


# load some images into an image list 
il = wx.ImageList(32,32，True )# 创 建 图 像 列表 
for name in glob.glob("icon??.png"): 
bmp = wx.Bitmap(name, wx.BITMAP TYPE PNG) 
il max - il.Add(bmp) 


# create the list control 
# 创 建 列 表 窗 口 部 件 
self.list = wx.ListCtrl(self, -1, 
style=wx.LC_ICON | wx.LC_AUTOARRANGE ) 


# assign the image list to it 
self.list.AssignImageList(il, wx.IMAGE LIST NORMAL) 


4 create some items for the list 
# 为 列表 创建 一 些 项 目 
for x in range(25): 
img = x % (il_max+1) 
self.list.InsertImageStringItem(x, 
"This is item %02d" % x, img) 


app = wx.PySimpleApp( ) 
frame = DemoFrame() 
frame.Show() 
app.MainLoop() 


图 13.1 
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在 例 13.1 中 > DemoFrame 创建 了 一 个 " image list (图 像 列 表 ) "来 包含 对 要 显 
示 的 图 像 的 引用 ， 然 后 它 建造 并 扩充 了 这 个 列表 控件 。 我 们 将 在 本 章 稍 后 的 部 分 讨 
i£" image list (图 像 列表 ) ”。 

什么 是 小 图 标 模式 ? 

小 图 标 模 式 类 似 标 准 的 图 标 模式 ， 但 是 图 标 更 小 点 。 图 13.2 以 小 图 标 模式 显示 了 相 
同 的 列表 。 


当 你 想 在 窗口 部 件 中 放 入 更 多 的 显示 项 目 时 ， 小 图 标 模式 是 最 有 用 的 ， 尤 其 是 当 图 
标 不 够 精细 时 。 


图 13.2 
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Figure 13.2 
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产生 图 13.2 的 示例 代码 如 下 : 


import wx 
import sys, glob 


class DemoFrame(wx.Frame): 
def _ init (self): 
wx.Frame. (init (self, None, -1, 
"wx.ListCtrl in wx.LC SMALL ICON mode" 


size=(600, 400) ) 


# load some images into an image list 

il = wx.ImageList(16,16, True) 

for name in glob.glob("smicon??.png"): 
bmp = wx.Bitmap(name, wx.BITMAP TYPE PNG) 
il max - il.Add(bmp) 


# create the list control 

self.list = wx.ListCtrl(self, -1, 
style-wx.LC SMALL ICON 
| wx.LC AUTOARRANGE 
) 


# assign the image list to it 
self.list.AssignImageList(il, wx.IMAGE LIST SMALL) 


4 create some items for the list 
for x in range(25): 
img = x % (il max-*1) 
self.list.InsertlImageStringItem(x, 
"This is item %02d" 
96 X, 
img) 


app - wx.PySimpleApp() 
frame = DemoFrame() 
frame.Show() 
app.MainLoop() 


什么 是 列表 模式 ? 


在 列表 模式 中 ， 列 表 以 多 列 的 形式 显示 ， 一 列 到 达 底 部 后 自动 从 下 一 列 的 上 部 继 
续 ， 如 图 13.3 所 示 。 


列 模式 在 相同 元 素 的 情况 下 ， 几 乎 与 小 图 标 模 式 所 能 容纳 的 项 目 数 相同 。 对 这 两 个 
模式 的 选择 ， 主 要 是 根据 你 的 数据 是 按 列 组 织 好 呢 还 是 按 行 组 织 好 。 


图 13.3 
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产生 图 13.3 的 示例 代码 如 下 : 


import wx 
import sys, glob 


class DemoFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, -1, 


"wx.ListCtrl in wx.LC LIST mode", 


size=(600, 400) ) 


# load some images into an image list 

il = wx.ImageList(16,16, True) 

for name in glob.glob("smicon??.png"): 
bmp = wx.Bitmap(name, wx.BITMAP TYPE PNG) 
il max - il.Add(bmp) 


# create the list control 


self.list = wx.ListCtrl(self, -1, style-zwx.LC LIST) 


# assign the image list to it 


self.list.AssignImageList(il, wx.IMAGE LIST SMALL) 


4 create some items for the list 

for x in range(25): 
img = x % (il max-*1) 
self.list.InsertImageStringItem(x, 


"This is item %02d" 


96 X, 
img) 


app - wx.PySimpleApp() 
frame = DemoFrame() 
frame.Show( ) 

app .MainLoop( ) 


第 十 三 草 建造 列表 控件 并 管理 列表 项 


在 报告 模式 中 ， 列 表 显 示 为 卜 正 的 多 列 格式 ， 每 行 可 以 有 任 一 数量 的 列 ， 如 图 13.4 
所 示 。 


图 13.4 





additions to RIT? 2004-07-08 10:2; 
wexTextCtrl - disable auto-scralling 2003-11-20 21:25 
Less flicker when resizing è window 2003-11-20 21:24 
Wishlist - v/xDbGetConnection return value 2003-11-20 21:22 
waPostscrigtDC with floating point coordinates 2003-11-20 21:27 = 
Wishlist - Better wxString Formatting 2003-11-20 21:27 
Wishlist - Crossplatform wofüchText Widget 2003-11-20 21:20 
Support for paper trays when printing 2004-05-13 08:01 
mac menu - Window menu 2004-05-12 03:1€ 
FloatCanvas demo should work with numarray 2004-04-03 08:3(— 
wxGrid: Support for Search / Replace 2004-03-09 05;4t 
wxComboBox - add small icons as in MSW CComboBoxEx — 2004-02-20 04:0« 
Please add more codepages support to your source buit — 2004-02-19 15;4¢ 





trigger on event-system creation 2004-02-11 08:1( 

HitTest in wxCheckListBox 2004-01-03 01:23 

wexGrid - Thaw/Freeze columryrow 2003-12-19 17:5« 

waddenu anchor right position in wxMenuBar 2004-06-18 08:4« 

waColourEnumerator 2004-06-09 11:4. Figure 13.4 

wx.Grid aridlines oast max row/ool 2004-05-24 19:35" | A sample list control 
= WE in report mode 


报告 模式 与 图 标 模 式 不 尽 相 同 。 例 13.2 显 示 了 图 13.4 的 代码 。 
例 13.2 创建 报告 模式 的 一 个 列表 
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#!/usr/bin/python 

#-*- encoding:UTF-8 -*- 
import wx 

import sys, glob, random 
import data 


class DemoFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, -1, 
"wx.ListCtrl in wx.LC REPORT mode", 
size=(600, 400) ) 


il = wx.ImageList(16,16, True) 
for name in glob.glob("smicon??.png"): 
bmp = wx.Bitmap(name, wx.BITMAP_TYPE_PNG) 
il max = il.Add(bmp) 
self.list = wx.ListCtrl(self, -1, style-wx.LC REPORT )# 创 


建 列 表 
self.list.AssignImageList(il, wx.IMAGE LIST SMALL) 
# Add some columns 
for col, text in enumerate(data.columns) :# 增 加 列 
self.list.InsertColumn(col, text) 
# add the rows 
for item in data. rows: #28 %fT 
index = self.list.InsertStringItem(sys.maxint, item[ 
0]) 


for col, text in enumerate(item[1:]): 
self.list.SetStringItem(index, col+i, text) 


# give each item a random image 
img = random.randint(O, il max) 
self.list.SetItemImage(index, img, img) 


4 set the width of the columns in various ways 
self.list.SetColumnWidth(0, 120)#7% E7455, 
self.list.SetColumnWidth(1, wx.LIST AUTOSIZE) 
self.list.SetColumnWidth(2, wx.LIST AUTOSIZE) 
self.list.SetColumnWidth(3, wx.LIST AUTOSIZE USEHEADER) 


app = wx.PySimpleApp() 
frame = DemoFrame() 
frame. Show( ) 

app .MainLoop( ) 


注意 RR NUR PAP LAP LE MARE RGA Ko LH 
encoding: UTF -8 -- 


在 接 下 来 的 部 分 ， 我 们 将 讨论 如 何 将 值 插入 适当 的 位 置 。 报 告 控 件 是 最 适合 
些 包 含 一 两 个 附加 的 数据 列 的 简单 列表 ， 它 的 显示 逻辑 没有 打算 做 得 很 复杂 。 如 果 
你 的 列表 控件 复杂 的 话 ， 或 包含 更 多 的 数据 的 话 ， 那 么 建议 你 使 用 grid 控件 ， 说 
明 见 第 14 章 。 


如 何 创 建 一 个 列表 控件 ? 


一 个 wxPython 列表 控件 是 类 wx.Listctrl 的 一 个 实例 。 它 的 构造 函数 与 其 它 的 
窗口 部 件 的 构造 函数 相似 : 


wx.ListCtrl(parent, id, pos=wx.DefaultPosition, 


e size=wx.DefaultSize, style-wx.LC ICON, 
validator-wx.DefaultValidator, name- " listCtrl ") 


这 些 参数 我 们 在 其 它 的 窗 口 部 件 的 构造 函数 中 见 过 。 参数 parent 是 容器 部 

件 ， id 是 wxPython 标识 符 ， 使 用 -1 表明 自动 创建 标识 符 。 具 体 的 布局 由 参 
数 pos 和 size 来 管理 。 style 控制 模式 和 其 它 的 显示 方案 FAH > R 
们 都 将 看 到 这 些 值 。 参 数 validator 用 于 验证 特定 的 输入 ， 我 们 在 第 9 章 讨论 
过 。 参 数 name 我 们 很 少 使 用 。 


样式 ( style ) 标记 是 一 个 位 掩 码 ， 它 管理 列表 控件 的 一 些 不 同 的 特定 。 样 式 标 
记 的 第 一 组 值 用 于 设置 列表 的 显示 模式 。 默 认 模 式 是 wx ,LC ICON 。 表 13.1 显 示 了 
列表 控件 的 模式 值 。 


表 13.1 列表 控件 模式 值 





wx.LC_ICON 图 标 模 式 ， 使 用 大 图 标 
wx.LC_LIST 列表 模式 
wx.LC REPORT 报告 模式 
wX.LC SMALL ICON 图 标 模式 ， 使 用 小 图 标 


在 图 标 或 小 图 标 列 表 中 ， 有 三 个 样式 标记 用 来 控件 图 标 相 对 于 列表 对 齐 的 。 默 认 值 
是 wX.LC ALIGN TOP ， 它 按 列表 的 顶部 对 齐 。 要 左 对 齐 的 话 ， 使 

用 wx.LC ALIGN LEFT 。 样 式 LC_AUTOARRANGE 使 得 当 图 标 排列 到 达 窗 口 右 或 底 
边 时 自动 换行 或 换 列 。 


表 13.2 显 示 了 作用 于 报告 列表 显示 的 样式 。 
表 13.2 报告 列表 的 显示 样式 


wX.LC HRULES 在 列表 的 行 与 行 间 显 示 网 格 线 (水 平分 隔 线 ) 
wX.LC NO HEADER 不 显示 列 标题 


wx.LC_VRULES 显示 列 与 列 之 间 的 网 格 线 ( 坚 直 分 隔 线 ) 


样式 标记 可 以 通过 位 运算 符 来 组 合 。 使 

用 wx.LC REPORT | wx.LC HRULES | wx.LC_VRULES 组 合 可 以 得 到 一 个 非常 像 网 
格 的 一 个 列表 。 默 认 情 况 下 ， 所 有 的 列表 控件 都 允许 多 选 。 要 使 得 一 次 只 能 选 列 表 
中 的 一 个 项 目 ， 可 以 使 用 标记 wx.LC_SINGLE_SEL 。 


与 我 们 见 过 的 其 它 的 窗口 部 件 不 同 ， 列表 控 件 增加 了 一 对 用 于 在 运行 时 改变 已 存在 
的 列表 控件 的 样式 标记 的 方法 。 SetsingleStyle(style, add-True) 方法 使 你 
能 够 增加 或 去 掉 一 个 样式 标记 ， 这 依赖 于 参数 add 的 

值 。 listCtrl.SetSingleStyle(LC HRULES, True) 将 增加 水 平分 隔 线 ， 

而 listCtrl.SetSingleStyle(LC_HRULES, False) 将 去 掉 水 平分 隔 

A listctrl 代表 具体 的 列表 控件 。 SetWindowStyleFlag(style) 能 够 
整个 窗口 的 样式 ， 如 SetwindowStyleFlag(LC REPORT | LC NO HEADER) 。 这 
些 方 法 对 于 在 运行 时 修改 列表 控件 的 样式 就 有 用 处 的 。 


— 


处 理 列表 中 的 项 目 


一 旦 列表 控件 被 创建 ， 你 就 能 够 开始 将 信息 添加 到 该 列表 中 。 在 wxPython 中 ， 对 
干 统 文 本 信息 和 对 与 列表 中 的 每 个 项 目 相关 的 固 像 的 处 理 是 不 同 乓 。 在 接 下 来 的 几 
节 里 ， 我 们 将 如 何 添加 图 像 和 文本 到 你 的 列表 控件 中 。 


什么 是 一 个 图 像 列 表 以 及 如 何 将 图 像 添加 给 它 ? 


在 我 们 讨论 信息 是 如 何 被 添加 到 列表 控件 之 前 ， 我 们 需要 对 列表 如 何 控 制图 像 说 两 
的 。 任 何 使 用 在 一 个 列表 控件 中 的 图 像 ， 首 先 必须 被 添加 到 一 个 图 像 列 表 ， 图 像 列 
表 是 一 个 图 像 索 引 数组 ， 使 用 列表 控件 存储 。 当 一 个 图 像 与 列表 中 的 一 个 特定 项 目 
相关 联 时 ， 图 像 列表 中 的 该 图 像 的 索引 被 用 来 引用 该 图 像 ， 而 非 使 用 图 像 本 身 。 该 
机 制 确保 每 个 图 像 只 被 装载 一 次 。 这 是 为 了 在 一 个 图 标 被 列表 中 的 几 个 项 目 重复 使 
用 时 节约 内 存 。 它 也 允许 相同 图 像 的 多 个 版 本 之 间 的 相对 直接 的 连接 ， 这 些 版 本 被 
用 来 表示 不 同 的 模式 。 关 于 创建 wxPython 图 像 和 位 图 的 更 多 的 信息 ， 请 看 第 12 


sh 


章 。 
创建 一 个 图 像 列表 

图 像 列 表 是 wx.ImageList 的 一 个 实例 ， 构 造 函 数 如 下 : 

wx.ImageList(width, height, mask=True, initialCount=1) 

参数 width 和 height 指定 了 添加 到 列表 中 的 图 像 的 像素 尺寸 。 比 指定 大 小 大 的 
图 像 是 不 允许 的 。 参 数 mask 是 一 个 布尔 值 。 如 果 为 True ， 假 如 图 像 有 遮 唱 ， 


则 使 用 让 单 绘制 图 像 。 参 数 initialCount 设置 列表 的 初始 的 内 在 尺寸 。 如 果 你 
知道 列表 会 很 大 ， 那 么 指定 初始 量 可 以 获得 更 多 的 内 存 分 配 以 便 稍 后 使 用 。 


添加 及 移 去 图 像 


你 可 以 使 用 方法 Add(bitmap, mask=wx.NullBitmap) 来 将 一 个 图 像 添加 到 列 

参数 bitmap 和 mask 都 是 wx.Bitmap 的 实例 。 mask 参数 是 一 个 单 色 位 
， 它 代表 该 图 像 的 透明 部 分 ， 如 果 指 定 了 mask 参数 的 话 。 如 果 位 图 已 经 有 一 个 

， ， 那么 该 庶 黑 被 默认 使 用 。 如 果 位 图 没有 一 个 庶 章 ， 并 且 你 不 使 用 


单 色 透明 映射 ， 但 设置 了 该 位 图 的 一 个 特定 颜色 作为 这 个 透明 色 的 话 ， 那 么 你 可 以 
使 用 AddwithColourMask(bitmap ， colour) 方法 ， 其 中 参数 colour 是 用 作 
遮 单 的 wxPython 颜色 【或 它 的 颜色 名 ) 。 如 果 你 有 一 个 wx.Icon 对 象 要 添加 到 
图 像 列表 ， 可 以 使 用 方法 AddIcon(icon) 。 所 有 这 些 添 加 方法 都 返回 这 个 新 加 的 
图 像 在 列表 中 的 索引 值 ， 你 可 以 保留 索引 值 以 便 日 后 使 用 该 图 像 。 


下 面 的 代码 片断 显示 了 一 个 创建 图 像 列 表 的 例子 〈 类 似 于 例 13.1 中 的 ) 。 


il = wx.ImageList(32, 32, True) 

for name in glob.glob("icon??.png"): 

bmp = wx.Bitmap(name, wx.BITMAP TYPE PNG) 
il max - il.Add(bmp) 


然后 这 个 图 像 列表 必须 被 赋 给 一 个 列表 控件 ， 使 用 下 面 的 方法 : 
self.list.AssignImageList(il, wx.IMAGE LIST NORMAL) 


要 从 图 像 列表 删除 一 个 图 像 ， 可 以 使 用 Remove(index) FH: HPA index X 
图 像 在 图 像 列 表 中 的 整数 索引 值 。 这 个 方法 会 修 删 除 点 之 后 的 图 像 在 图 像 列 表 中 的 
索引 值 ， 如 果 在 你 的 程序 中 有 对 特定 的 索引 存在 依赖 关系 的 话 ， 这 可 能 会 导致 一 些 
问题 。 要 删除 整个 图 像 列 表 ， 使 用 RemoveAll() 。 你 可 以 使 用 方 

法 Replace(index, bitmap, mask=wx.NullBitmap) 修改 特定 索引 相关 的 位 

图 ， 其 中 index 是 列表 中 要 修改 处 的 索引 ， bitmap 和 mask 与 Add() 方法 中 
的 一 样 。 如 果 要 修改 的 项 目 是 一 个 图 标 ， 可 以 使 用 方 

法 ReplaceIcon(index, icon) 。 这 里 没有 处 理 颜 色 遮 章 的 替换 方法 。 


使 用 图 像 列 表 


通过 使 用 方法 GetImageCount() ， 你 能 够 得 到 图 像 列 表 的 长 度 ， 使 
用 GetSize() 方法 ， 你 可 以 得 到 其 中 个 个 图 像 的 尺寸 ， 它 返回 一 个 
( width，height) 元 组 。 


在 列表 控件 上 下 文中 没有 直接 相关 的 图 像 的 时 候 ， 你 也 可 以 根据 图 像 列表 绘制 一 个 
图 像 到 设备 上 下 文中 。 关 于 设备 上 下 文 的 更 多 信息 ， 请 看 第 6 章 和 第 12 章 。 这 个 方 
法 是 Draw ， 如 下 所 示 : 


Draw(index, dc, x, y, flags=wx.IMAGELIST_DRAW_NORMAL, 
solidBackground=False) 


在 这 个 调用 中 ， 参 数 index 是 要 绘制 的 项 目 在 图 像 列表 中 的 索引 ， 参 数 dc 是 要 

绘制 到 的 一 个 wx.DC 设备 上 下 文 。 flags 控制 图 像 被 如 何 绘 制 ， flags NTR 
值 

有 wx.IMAGELIST DRAW NORMAL, wx.IMAGELIST DRAW TRANSPARENT, wx.IMAGEI 
和 wx.IMAGELIST DRAW FOCUSED 。 如 果 solidBackground 为 True * MALÈ 

绘制 方法 使 用 一 个 更 快 的 算法 工作 。 


一 旦 你 有 了 一 个 图 像 列 表 ， 你 就 需要 将 它 附 给 列表 控件 。 这 个 以 通过 后 面 的 任 一 个 
方法 来 实 

3L: AssignImage(imageList, which) 或 SetImage(imageList, which) ° i 
参数 是 一 个 图 像 列表 ， 参 数 which 是 标记 值 : wx.IMAGE LIST NORMAL 或 
wx.IMAGE LIST SMALL 。 这 两 个 方法 的 唯一 的 不 同 之 处 是 C++ 对 图 像 列表 的 处 理 
方面 。 对 于 AssignImage() ， 图 像 列 表 变 成 了 列表 控件 的 一 部 分 ， 并 随 列 表 控 件 
的 销毁 而 销毁 。 对 于 SetImage() ， 图 像 列 表 有 自己 的 生命 周期 ， 当 列表 控件 被 
销毁 时 不 被 自动 处 理 ， 只 是 当 其 Python 对 象 退 出 作用 域 时 ， 才 被 处 理 。 


可 以 赋 给 列表 控件 两 个 图 像 列 表 。 普 通 的 图 像 列表 (使 用 

了 wx.IMAGE LIST NORMAL ) 被 用 于 标准 的 图 标 模式 。 小 图 像 列表 (使 用 

了 wx.IMAGE LIST SMALL ) 被 用 于 报告 和 小 图 标 模式 。 在 大 多 数 情况 下 ， 你 只 需 
要 一 个 图 像 列表 ， 但 是 如 果 你 希望 列表 以 多 模式 显示 (这样 用 户 可 以 从 普通 模式 切 
换 到 小 图 标 模式 ) ， 那 和 勾 你 应 该 两 个 都 提供 。 如 果 你 这 样 做 了 ， 那 么 记 住 ， 列 表 控 
件 中 的 选项 将 只 会 经 由 图 像 列表 中 的 索引 知道 相关 的 图 像 。 如 果 文 档 图 标 在 普通 尺 
寸 的 图 像 列表 中 有 两 个 索引 ， 那 么 也 必须 在 小 图 像 列表 中 有 两 个 索引 。 


关于 列表 控件 还 有 一 个 相关 的 get * 方 法 : GetImageList(which) ， 它 返回 
与 which 标记 参数 相关 的 图 像 列表 。 


如 何 对 一 个 列表 添加 或 删除 项 目 ? 


在 你 能 显示 一 个 列表 之 前 ， 你 需要 给 它 增加 文本 信息 。 在 一 个 图 标 列 表 中 ， 你 可 以 
增加 新 的 项 目 如 图 标 、 字 符 串 或 两 个 都 添加 。 在 一 个 报告 视图 中 ， 你 也 可 以 在 设置 
了 初始 图 标 和 /或 字符 串 后 ， 为 一 行 中 的 不 同 的 列 设 置信 息 。 用 于 处 理 列表 控件 项 目 
的 方法 的 API 及 其 命名 习惯 与 迄今 为 止 我 们 所 见 过 的 其 它 一 些 控件 的 是 有 区 别 
的 ， 因 此 ， 尽 管 你 已 经 理解 了 菜单 或 列表 框 是 如 何 工作 的 ， 但 是 你 仍 将 需要 读 这 一 
Y o 

对 于 一 个 图 标 列表 ， 增 加 文本 信息 到 列表 控件 是 一 个 单 步 的 处 理 过 程 ， 但 是 对 于 一 
个 报告 列表 就 需要 多 步 才 行 。 通 常 对 于 每 个 列表 ， 第 一 步 是 在 行 中 增加 第 一 个 项 

目 。 对 于 报告 列表 ， 你 必须 分 别 地 增加 列 和 列 中 的 信息 ， 而 非 最 左边 的 一 个 。 


增加 一 个 新 行 


要 增加 一 个 新 行 ， 使 用 InsertItem() 这 类 的 一 种 方法 。 上 有 具体 所 用 的 方法 依赖 于 
你 所 插入 的 项 目的 类 型 。 如 果 你 仅仅 插入 一 个 字符 串 到 列表 中 ， 使 

用 InsertStringItem(index, label) ， 其 中 的 index 是 要 插入 并 显示 新 项 目 
的 行 的 索引 。 如 果 你 只 插入 一 个 图 像 ， 那 么 使 

用 InsertImageItem(index, imageIndex) 。 在 这 种 情况 下 ， 这 index 是 要 插 
入 图 像 的 行 的 索引 ， imageIndex 是 附加 到 该 列表 控件 的 图 像 列 表 中 的 图 像 的 索 
引 。 要 插入 一 个 图 像 项 目 ， 图 像 列表 必须 已 经 被 创建 并 赋值 。 如 果 你 使 用 的 图 像 索 
引 超 出 了 图 像 列表 的 边界 ， 那 么 你 将 得 到 一 个 空 图 像 。 如 果 你 想 增 加 一 个 既 有 图 像 
又 有 字符 串 标签 的 项 目 ， 使 

用 InsertImageStringItem(index, label, imageIndex) 。 这 个 方法 综合 了 前 
面 两 个 方法 的 参数 ， 参 数 的 意义 不 变 。 


在 内 部 ， 列 表 控 件 使 用 类 wx.ListItem 的 实例 来 管理 有 关 它 的 项 目的 信息 。 我 还 
要 说 的 是 ， 最 后 一 种 插入 项 目 到 列表 控 M eee InsertItem(index, SES , 
其 中 的 item 是 wx.ListItem 的 一 个 实例 。 对 于 wx.ListItem ， 这 里 我 们 不 将 
做 很 详细 的 说 明 ， 这 是 因为 你 几乎 不 会 用 到 它 并 且 该 类 也 不 很 复杂 一 一 它 几乎 都 是 
由 get 和 set 方法 组 成 的 。 一 个 列表 项 的 几乎 所 有 属性 都 可 通过 列表 控件 的 方法 
来 访问 。 

增加 列 


要 增加 报告 模式 的 列表 控件 的 列 ， 先 要 创建 列 ， 然 后 设置 每 行 / 列 对 的 单独 的 数据 单 
元 格 。 使 用 Insertcolumn() 方法 创建 列 ， 它 的 语法 如 下 : 


InsertColumn(col, heading, format=wx.LIST_FORMAT_LEFT, width=-1) 


在 这 个 方法 中 ， 参 数 col 是 列表 中 的 新 列 的 索引 ， 你 必须 提供 这 个 值 。 参 
数 heading 是 列 标题 。 参 数 format 控件 列 中 文本 的 对 齐 方式 ， 取 值 
A: WX.LIST FORMAT CENTRE ^ wx.LIST FORMAT LEFT 、 和 
wx.LIST_FORMAT_RIGHT 。 参数 width 是 列 的 初始 显示 宽度 (像素 单位 ) 
用 户 可 以 通过 拖 动 列 的 头 部 的 边 来 改变 它 的 宽度 。 要 使 用 一 个 wx .ListItem 对 象 
来 设置 列 的 话 ， 也 有 一 个 名 为 InsertcolumnInfo(info) 的 方法 ， 它 要 求 一 个 列 
表 项 作为 参数 。 


设置 多 列 列表 中 的 值 


你 可 能 已 经 注意 到 使 用 前 面 说 明 的 行 的 方法 来 插入 项 目 ， 对 于 一 个 多 列 的 报告 列表 
来 说 只 能 设置 最 初 的 那 列 。 要 在 另外 的 列 中 设置 字符 串 ， 可 以 使 用 方 
法 SetStringItem() ° 





SetStringItem(index, col, label, imageId--1) 


参数 index fe col 是 你 要 设置 的 单元 格 的 行 和 列 的 索引 。 你 可 以 设 col aes 
来 设置 第 一 列 ， 但 是 参数 index 必须 对 应 列表 控件 中 ed a x 
个 方法 只 能 对 已 有 的 行使 有 用。 参数 label 是 显示 在 单元 格 中 文本 ， 

数 imageld 是 图 像 列表 中 的 索引 〈 如 果 你 想 在 单元 格 中 显示 一 个 图 像 的 话 可 以 设 
置 这 个 参数 ) 。 





SetStringItem() 是 SetItem(info) 方法 的 一 种 特殊 情 

IL? SetItem(info) 方法 要 求 一 个 wx.ListItem 实例 。 要 使 用 这 个 方法 ， 在 
将 wx.ListItem 实例 增加 到 一 个 列表 之 前 ， 要 先 设 置 它 行 ， 列 和 其 它 的 参数 。 你 
也 可 以 使 用 GetItem(index,col=0) 方法 来 得 到 suce wx.ListItem & 
例 ， 黑 认 情 况 下 ， 该 方法 返回 一 行 的 第 一 列 ， 你 可 以 通过 设置 参数 col 来 选择 其 
它 列 的 一 项 。 


项 目 属性 


有 许多 的 get 和 set 方法 使 你 分 项 目 。 通 常 这 些 方 法 工作 在 一 行 的 第 
一 列 上 。 要 得 工作 在 其 它 的 列 上 MR GetItem() 来 得 到 项 目 ， 并 使 用 项 
目 类 的 get 和 set 方法 。 你 可 以 使 

用 SetItemImage(item, image, sellmage) 来 为 一 个 项 目 设 置 图 像 ， 其 中 

的 参数 是 该 项 目 在 列表 中 的 索引 ， image 和 selImage 都 是 图 像 列 表 中 的 
索引 ， 分 别 代 表 通 常 显示 的 图 像 和 被 选中 时 显示 的 图 像 。 你 可 以 通过 使 

用 =e Pa SCTE 和 SetItemText(item, text) 方法 来 得 到 或 设置 一 个 项 
目的 文本 。 


你 可 以 使 

用 GetItemState(item,stateMask) 和 SetItemState(item, state, stateMas 
来 得 到 或 设置 单独 一 个 项 目的 状态 。 state 和 stateMask 的 取 值 见 表 13.3。 参 

数 state (A GetItemState 的 返回 值 ) 是 项 目的 实际 状态 statemask 是 当 
前 关注 的 所 有 可 能 值 的 一 个 掩 码 。 


你 可 以 使 用 Getcolumn(col) 来 得 到 一 个 指定 的 列 ， 它 返回 索引 col 处 的 列 
的 wx.ListItem 实例 。 


表 13.3 3 4 48 88 ZR 

状态 及 说 明 如 下 : 

被 剪 切 状态 。 这 个 状态 只 在 微 
软 Windows 下 有 效 。 


无 关 状 态 。 这 个 状态 只 在 微软 Windows 下 


wx.LIST_STATE_CUT 


wx.LIST_STATE_DONTCARE 


HARASA. MAERA AR?’ ARAR 
wX.LIST STATE DropHILITED 
一 Erdal 在 微软 Windows 下 有 效 。 
wx.LIST STATE FOCUSED 获得 光标 焦点 状态 。 
wx.LIST_STATE_SelectED 被 选中 状态 。 


你 也 可 以 用 Setcolumn(col, item) 方法 对 一 个 已 添加 的 列 进行 设置 。 你 也 可 以 
在 程序 中 用 Getcolumwidth(col) 方法 方法 得 到 一 个 列 的 宽度 ， 该 方法 返 回 列表 
的 宽度 (像素 单位 ) 显然 这 只 对 报告 模式 的 列表 有 用 。 你 可 以 使 

用 Setcolumnwidth(col,width) 来 设置 列 的 宽度 。 这 个 width 可 以 是 一 个 整数 
值 或 特殊 值 ， 这 些 特殊 值 有 : wx.LIST AUTOSIZE ， 它 将 列 的 宽 度 设 置 为 最 长 项 
目的 宽度 ， 或 wx.LIST AUTOSIZE USEHEADER ， 它 将 宽度 设置 为 列 的 首部 文本 
( 列 标题 ) 的 宽度 。 在 非 Windows 操作 系统 

F> wx.LIST AUTOSIZE USEHEADER 可 能 只 自动 地 将 列 宽度 设置 到 80 像 素 。 


如 果 你 对 已 有 的 索引 不 清楚 了 ， 你 可 以 查询 列表 中 项 目的 数量 。 方 法 

有 GetColumnCount() ， 它 返回 列表 中 所 定义 的 列 的 数量 ， GetItemCount() 返 
回 行 的 数量 。 如 果 你 的 列表 是 列表 模式 ， 那 么 方法 GetcountPerPage() 返回 每 列 
中 项 目的 数量 。 





要 从 列表 中 删除 项 目 ， 使 用 DeleteItem(item) 方法 ， 参 数 item 是 项 目 在 列表 
中 的 索引 。 如 果 你 想 一 次 删除 所 有 的 项 目 ， 可 以 使 

用 DeleteAllItems() 或 ClearAll() 。 你 可 以 使 用 DeleteColumn(col) 删除 
一 列 ， col 是 列 的 索引 。 


响应 用 己 


通常 ， 一 个 列表 控件 在 当 用 户 选 择 了 列表 中 的 一 个 项 目 后 都 要 做 一 些 事情 。 在 接 下 
来 的 部 分 ， 我 们 将 展示 一 个 列表 控件 都 能 响应 哪些 事件 ， 并 提供 一 个 使 用 列表 控件 
事件 的 例子 。 


如 何 响应 用 户 在 列表 中 的 选择 ? 


像 别 的 控件 一 样 ， 列 表 控 件 也 触发 事件 以 响应 用 户 的 动作 。 你 可 以 像 我 们 在 第 三 章 
那样 使 用 Bind() 方法 为 这 些 事件 设置 处 理 器 。 所 有 这 些 事件 处 理 器 都 接受 一 

个 wx.ListEvent 实例 ， wx.ListEvent 是 wx.CommandEvent 的 子 

Ho wx.ListEvent 有 少量 专用 的 get * 方 法 。 某 些 属性 只 对 特定 的 事件 类 型 有 
效 ， 这 些 特定 的 事件 类 型 在 本 章 的 另外 部 分 说 明 。 适 用 于 所 有 事件 类 型 的 属性 见 表 
13.4。 


表 13.4 wx.ListEvent 的 属性 


GetData() 与 该 事件 的 列表 项 相关 的 用 户 数据 项 
GetKeyCode() 在 一 个 按键 事件 中 ， 所 按 下 的 键 的 键 码 
Get Index() 得 到 列表 中 与 事件 相关 的 项 目的 索引 
GetItem() 得 到 与 事件 相关 的 实际 的 wx.ListItem 
GetImage() 得 到 与 事件 相关 单元 格 中 的 图 像 
GetMask() 得 到 与 事件 相关 单元 格 中 的 位 掩 码 
GetPoint() RSH a SUL E 

GetText() 得 到 与 事件 相关 的 单元 格 中 的 文本 


这 儿 有 几 个 关于 wx.ListEvent 的 不 同 的 事件 类 型 ， 每 个 都 可 以 有 一 个 不 同 的 处 
理 器 。 某 些 关 联 性 更 强 的 事件 将 在 后 面 的 部 分 讨论 。 表 13.5 列 出 了 选择 列表 中 的 项 
目 时 的 所 有 事件 类 型 。 


表 13.5 与 选择 一 个 列表 控件 中 的 项 目 相 关 的 事件 类 型 


EVT_LIST_BEGIN_DRAG 


EVT_LIST_BEGIN_RDRAG 


EVT_LIST_Delete_ALL_ITEMS 


EVT_LIST_Delete_ITEM 
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MIDDLE_CLICK 


RIGHT_CLICK 


SelectED 


LIST_ITEM_KEY_DOWN 





当 用 户 使 用 鼠标 堪 按 键 开 始 一 个 拖 动 操作 
时 ， 触 发 该 事件 


当 用 户 使 用 鼠标 右 按 键 开 始 一 个 拖 动 操作 
时 ， 触 发 该 事件 


调用 列表 的 DeleteAll() 将 触发 该 事件 
调用 列表 的 Delete() 将 触发 该 事件 


当 一 个 项 目 被 插入 到 列表 中 时 ， 触 发 该 事 
件 


用 户 通过 在 已 选择 的 项 目 上 按 下 回 车 或 双 
击 来 激活 一 个 项 目 时 


当 项 目 被 取消 选择 时 触发 该 事件 

当 项 目的 焦点 变化 时 触发 该 事件 

当 在 列表 上 敲 击 了 鼠标 的 中 间 按 钮 时 触发 
该 事件 

当 在 列表 上 敲 击 了 和 所 标的 右 按钮 时 触发 该 
事件 

当 通 过 敲 击 氮 标 左 按钮 来 选择 一 个 项 目 
时 ， 触 发 该 事件 

在 列表 控件 已 经 获得 了 焦点 时 ， 一 个 按键 
被 按 下 将 触发 该 事件 


下 节 中 例 13.3 将 提供 一 个 关于 上 述 事件 中 的 一 些 事件 的 应 用 例子 。 


如 何 响 应 用 户 在 一 个 列 的 首部 中 的 选择 ? 


除了 用 户 在 列表 体 中 触发 的 事件 以 外 ， 还 有 在 报告 列表 控件 的 列 首 中 所 触发 的 事 
件 。 列 事件 创建 的 wx.ListEvent 对 象 有 另 一 个 方法 : GetColumn() ， 该 方法 返 
回 产生 事件 的 列 的 索引 。 如 果 事 件 是 一 个 列 边框 的 拖 动 事件 ， 那 么 这 个 索引 是 所 拖 
动 的 边框 的 左边 位 置 。 如 果 事 件 是 一 个 斋 击 所 触发 的 ， 且 斋 击 不 在 列 内 ， 那 么 该 方 
法 返回 一 1。 表 13.6 包 含 了 列 事件 类 型 的 列表 。 


表 13.6 列表 控件 列 事件 类 型 


当 用 户 开 始 拖 动 一 个 列 的 边框 时 ， 触 发 该 事 
件 


EVT_LIST_COL_CLICK 列表 首部 内 的 一 个 敲 击 将 触发 该 事件 
EVT_LIST_COL_RIGHT_CLICK 列表 首部 内 的 一 个 右 击 将 触发 该 事件 

当 用 户 完 成 对 一 个 列表 边框 的 拖 动 时 ， 触 发 
该 事件 

例 13.3 显 示 了 一 些 列表 事件 的 处 理 ， 并 也 提供 了 方法 的 一 些 演示 。 

例 13.3 一 些 不 同 列表 事件 和 属性 的 一 个 例子 


EVT_LIST_COL_BEGIN_DRAG 


EVT_LiST_COL_END_DRAG 





import wx 
import sys, glob, random 
import data 


class DemoFrame(wx.Frame): 
def — init (self): 

wx.Frame. init (self, None, -1, 
"Other wx.ListCtrl Stuff", 
size-(700,500)) 

self.list - None 

self.editable - False 

self.MakeMenu() 

self.MakeListCtrl() 


def MakeListCtrl(self, otherflags-0): 
# if we already have a listctrl then get rid of it 
if self.list: 
self.list.Destroy() 


if self.editable: 
otherflags |= wx.LC_EDIT_LABELS 


# load some images into an image list 

il = wx.ImageList(16,16, True) 

for name in glob.glob("smicon??.png"): 
bmp = wx.Bitmap(name, wx.BITMAP TYPE PNG) 
il max - il.Add(bmp) 


# create the list control 
self.list - wx.ListCtrl(self, -1, style-wx.LC REPORT|oth 
erflags) 


4 assign the image list to it 
self.list.AssignImageList(il, wx.IMAGE LIST SMALL) 


# Add some columns 
for col, text in enumerate(data.columns): 
self.list.InsertColumn(col, text) 


# ad 
for 


0]) 


n in 


# se 
self 
self 
self 
self 


# bi 
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def Make 
mbar 
menu 
item 


self. 


mbar 


menu 
item 


self .Bind(wx. 


item 


self. 


item 


self. 


menu 
item 


d the rows 
row, item in enumerate(data.rows): 
index = self.list.InsertStringItem(sys.maxint, item[ 


for col, text in enumerate(item[1:]): 
self.list.SetStringItem(index, col+i, text) 


# give each item a random image 
img = random.randint(0, il max) 
self.list.SetItemImage(index, img, img) 


# set the data value for each item to be its positio 


# the data list 
self.list.SetItemData(index, row) 


t the width of the columns in various ways 
.list.SetColumnwidth(0, 120) 
.List.SetColumnwidth(1, wx.LIST AUTOSIZE) 
.list.SetColumnWidth(2, wx.LIST AUTOSIZE) 
.list.SetColumnWidth(3, wx.LIST AUTOSIZE USEHEADER) 


nd some interesting events 
.Bind(wx.EVT LIST ITEM SelectED, self.OnItemSelected 





.Bind(wx.EVT LIST ITEM DESelectED, self.OnItemDesele 
ist) 

.Bind(wx.EVT LIST ITEM ACTIVATED, self.OnItemActivat 
t) 








case we are recreating the list tickle the frame a 


will redo the layout 
.SendSizeEvent() 


Menu(self): 

wx .MenuBar ( ) 

wx .Menu() 

menu.Append(-1, "E \tAlt-X") 
Bind(wx.EVT_MENU, self.OnExit, item) 
.Append(menu, " ") 


wx.Menu() 

menu.Append(-1, "Sort ascending") 

EVT MENU, self.OnSortAscending, item) 

= menu.Append(-1, "Sort descending") 
Bind(wx.EVT MENU, self.OnSortDescending, item) 
= menu.Append(-1, "Sort by submitter") 
Bind(wx.EVT_MENU, self.OnSortBySubmitter, item) 


.AppendSeparator ( ) 
= menu.Append(-1, "Show selected") 


self.Bind(wx.EVT MENU, self.OnShowSelected, item) 
item = menu.Append(-1, "Select all") 
self.Bind(wx.EVT MENU, self.OnSelectAll, item) 
item = menu.Append(-1, "Select none") 
self.Bind(wx.EVT MENU, self.OnSelectNone, item) 


menu.AppendSeparator ( ) 

item = menu.Append(-1, "Set item text colour") 
self.Bind(wx.EVT MENU, self.OnSetTextColour, item) 
item = menu.Append(-1, "Set item background colour") 
self.Bind(wx.EVT MENU, self.OnSetBGColour, item) 


menu.AppendSeparator() 

item = menu.Append(-1, "Enable item editing", kind-wx.IT 
EM CHECK) 

self.Bind(wx.EVT MENU, self.OnEnableEditing, item) 

item = menu.Append(-1, "Edit current item") 

self.Bind(wx.EVT MENU, self.OnEditItem, item) 

mbar.Append(menu, "  ") 


self .SetMenuBar (mbar) 


def OnExit(self, evt): 
self .Close() 


def OnItemSelected(self, evt): 
item = evt.GetItem() 
print "Item selected:", item.GetText() 


def OnItemDeselected(self, evt): 
item = evt.GetItem() 
print "Item deselected:", item.GetText() 


def OnItemActivated(self, evt): 
item = evt.GetItem() 
print "Item activated:", item.GetText() 


def OnSortAscending(self, evt): 
# recreate the listctrl with a sort style 
self.MakeListCtrl(wx.LC SORT ASCENDING) 


def OnSortDescending(self, evt): 
# recreate the listctrl with a sort style 
self.MakeListCtrl(wx.LC SORT DESCENDING) 


def OnSortBySubmitter(self, evt): 
def compare func(rowi, row2): 
# compare the values in the 4th col of the data 
vali = data.rows[row1] [3] 
val2 = data.rows[row2][3] 
if vali  val2: return -1 
if vali  val2: return 1 
return 0 


self.list.SortItems(compare_func) 


def OnShowSelected(self, evt): 
print "These items are selected:" 
index = self.list.GetFirstSelected() 


if index == - 
print "\tNone" 
return 

while index != -1: 


item = self.list.GetItem( index) 
print "\t%s" % item.GetText() 
index = self.list.GetNextSelected( index) 


def OnSelectAll(self, evt): 
for index in range(self.list.GetItemCount()): 
self.list.Select(index, True) 


def OnSelectNone(self, evt): 
index = self.list.GetFirstSelected() 
while index != -1: 
self.list.Select(index, False) 
index = self.list.GetNextSelected(index) 


def OnSetTextColour(self, evt): 
dlg = wx.ColourDialog(self ) 
if dlg.ShowModal() == wx.ID_OK: 
colour = dlg.GetColourData().GetColour() 
index = self.list.GetFirstSelected( ) 
while index != -1: 
self.list.SetItemTextColour(index, colour) 
index = self.list.GetNextSelected(index) 
dlg.Destroy() 


def OnSetBGColour(self, evt): 
dlg = wx.ColourDialog(self) 
if dlg.ShowModal() == wx.ID OK: 
colour - dlg.GetColourData().GetColour() 
index = self.list.GetFirstSelected() 
while index !- -1: 
self.list.SetItemBackgroundColour(index, colour) 
index - self.list.GetNextSelected(index) 
dlg.Destroy() 


def OnEnableEditing(self, evt): 
self.editable - evt.IsChecked() 
self.MakeListCtrl() 


def OnEditItem(self, evt): 
index - self.list.GetFirstSelected() 
if index !- -1: 
self.list.EditLabel(index) 


class DemoApp(wx.App): 
def OnInit(self): 
frame = DemoFrame() 
self .SetTopwindow( frame) 
print "Program output appears here..." 
frame .Show() 
return True 


app = DemoApp(redirect=True) 
app .MainLoop( ) 


— dli Oe Ce ee ee US ^ EASIER MAE 
序 ， 这 我 们 将 在 下 一 节 讨论 。 


在 这 一 节 ， 我 们 将 讨论 对 列表 控件 中 的 项 目 进行 编辑 、 排 序 和 想 找 。 


如 何 编辑 标签 ? 
除了 报告 列表 外 ， 编 辑 一 个 列表 中 的 项 目 是 简单 的 ， 在 报告 列表 中 ， 用 户 只 能 编辑 
一 行 的 第 一 个 一 。 而 对 于 其 它 的 列表 ， 则 没有 问题 ; 每 个 项 目的 标准 的 标签 都 是 可 


编辑 的 。 
要 使 一 个 列表 是 可 编辑 的 ， 则 当 列 表 被 创建 时 要 在 构造 函数 中 包 爹 样 ? 奖 县 锡 。 


list = wx.ListCtrl(self, -1, style-wx.LC REPORT 

wX.LC EDIT LABELS) 
de REGE AAR ICBOE T o PAM P MAB xL 4E — 4 C x5 4E 83 PLC ES 
开始 一 个 编辑 会 话 。 编 辑 完 后 按 下 Enter 键 结束 编辑 会 话 ， 新 的 文本 就 变 成 了 文 
本 标签 。 在 列表 控件 中 的 鼠标 敲 击 也 可 结束 编辑 会 话 (一 次 只 能 有 一 个 编辑 会 

i$) 。 按 下 Esc 键 则 取消 编辑 会 话 ， 这 样 的 话 ， 新 输入 的 文本 就 没有 用 了 。 

下 面 的 两 个 事件 类 型 是 由 编辑 会 话 触发 的 。 


e EVT LIST BEGIN LABEL EDIT 





e EVT LIST END LABEL EDIT 


记 住 ， 如 果 你 想 事 件 在 被 你 的 自 定 义 的 事件 处 理 器 处 理 后 继续 被 处 理 ， 那 么 你 需要 
在 你 的 事件 处 理 器 中 包括 Skipo 调用 。 当 用 户 开 始 一 个 编辑 会 话 时 ， 一 

个 EVT_LIST_BEGIN_LABEL_EDIT 类 型 的 列表 事件 被 触发 ， 当 会 话 结束 时 (通过 
使 用 Enter 或 Esc ) ， EVT LIST END LABEL EDIT 类 型 的 列表 事件 被 触发 。 
你 可 以 否决 ( veto) 编辑 事件 的 开始 ， 这 样 编辑 会 话 就 不 会 开始 了 。 否 决 编辑 事件 
的 结束 将 阻止 列表 文本 的 改变 。 


wx.ListEvent 类 有 两 个 属性 ， 这 两 个 属性 只 在 当 处 理 一 
个 EVT LIST END LABEL EDIT 事件 时 才 会 用 到 。 如 果 编 辑 结 束 并 确认 
Jz? GetLabel() 返回 列表 项 目标 签 的 新 文本 ， 如 果 编 辑 被 Esc BRAT > A 


Ak 


4 GetLabel() 返回 一 个 空 字 符 串 。 这 意味 着 你 不 能 使 用 GetLabel() 来 区 别 “ 取 


消 " 和 “用 户 故 意 输入 的 空 字 符 串 标签 ”*。 如 果 必 须 的 话 ， 可 以 使 
用 IsEditCancelled() ， 它 在 因 取 消 而 导致 的 编辑 结束 时 返回 True > SMR 
回 False 。 


如 果 你 想 通 过 其 它 的 用 户 事件 来 启动 一 个 编辑 会 话 的 话 ， 你 可 以 在 程序 中 使 用 列表 
控件 的 EditLabel(item) 方法 来 触发 一 个 编辑 。 其 中 的 item 参数 是 是 要 被 编辑 
的 列表 项 的 索引 。 该 方法 触发 EVT LIST BEGIN LABEL EDIT 事件 。 


如 果 你 愿意 直接 处 理 用 于 列表 项 编辑 控件 ， 你 可 以 使 用 列表 控件 的 方 

法 GetEditControl() 来 得 到 该 编辑 控件 。 该 方法 返回 用 于 当前 编辑 的 文本 控 
件 。 如 果 当 前 没有 编辑 ， 该 方法 返回 None 。 目 前 该 方法 只 工作 于 windows 操作 
系统 下 。 





boa - constructor 简介 


boa - constructor 是 一 个 跨 平 台 的 python 集成 开发 环境 和 wxPython 图 形 
用 户 界 面 构 建 器 。 它 提供 了 可 视 化 方式 的 框架 (窗口 ) 的 创建 和 处 理 、 对 象 检视 器 
( object inspector) 、 编 辑 器 、 继 承 的 等 级 、html 文档 字符 串 、 高 级 的 调试 
器 和 集成 化 的 帮助 系统 。 伍 然 一 个 用 于 Python 的 Delphi ° 


对 的 Zope 支持 : 对 象 的 创建 和 编辑 。 剪 切 ， 和 复制， 粘贴， 导入 和 导出 。 检 视 器 
( inspector) 和 Python 脚本 调试 中 的 创建 和 编辑 。 


boa - constructor 是 用 Python 和 wxPython 库 写 成 的 。 使 用 它 之 前 ， 你 必 
须 安 装 了 wxPython 2.4.0.7 或 wxPython 更 高 的 版 本 以 

及 Python 2.1 或 Python 的 更 高 的 版 本 。 建 议 在 使 用 boa - constructor 之 
前 ， 先 入 门 wxPython ° 


boa - constructor 项 目 位 于 SourceForge 中 。 下 载 boa - constructor 


如 何 对 列表 排序 ? 


在 wxPython 中 有 三 个 有 用 的 方法 可 以 对 列表 进行 排序 ， 在 这 一 节 ， 我 们 将 按照 从 
多 到 难 的 顺序 来 讨论 。 


在 创建 的 时 候 告诉 列表 去 排序 


对 一 个 列表 控件 排序 的 最 容易 的 方法 ， 是 在 构造 函数 中 告诉 该 列表 控件 对 项 目 进 行 
排序 。 你 可 以 通过 使 用 样式 标 

记 wx.LC SORT ASCENDING 或 wx.LC SORT DESCENDING 来 实现 。 这 两 个 标记 和 导 
致 了 列表 在 初始 显示 的 时 候 被 排序 ， 并 且 在 Windows 上 ， 当 新 的 项 目 被 添加 时 ， 
依然 遵循 所 样式 标记 来 排序 。 对 于 每 个 列表 项 的 数据 的 排序 ， 是 基于 其 字符 串 文本 
的 ， 只 是 简单 的 对 字符 串 进行 比较 。 如 果 列 表 是 报告 模式 的 ， 则 排序 是 基于 每 行 的 
最 左边 的 列 的 字符 串 的 。 


基于 数据 而 非 所 显示 的 文本 来 排序 


有 时 ， 你 想 根据 其 它 方面 而 非 列 表 标 签 的 字符 串 来 对 列表 排序 。 在 wxPython 中 ， 
你 可 以 做 到 这 一 点 ， 但 这 是 较为 复杂 的 。 首 先 ， 你 需要 为 列表 中 的 每 个 项 目 设置 项 
目 数据 ， 这 通过 使 用 SetItemData(item, data) 方法 。 参 数 item 是 项 目 在 未 


排序 的 列表 中 的 索引 ， 参 数 data 必须 是 一 个 整形 或 长 整形 的 值 (由 于 C++ 的 数据 
类 型 的 限制 ) ， 这 就 有 点 限制 了 该 机 制 的 作用 。 如 果 要 获取 某 行 的 项 目 数 据 ， 可 以 
使 用 方法 GetItemData(item) 。 


一 旦 你 设置 了 项 目 数 据 ， 你 就 可 以 使 用 方法 SortItems(func) 来 排序 项 目 。 参 
数 func 是 一 个 可 调用 的 Python Tr ， 它 需要 两 个 整数 。 func BH 
对 两 个 列表 项 目的 数据 进行 比较 你 不 能 得 到 行 自身 的 引用 。 如 果 第 一 项 比 第 二 
项 大 的 话 ， 有 子 数 将 返回 一 个 正 整数 ， 如 果 第 一 项 比 第 二 项 小 的 话 ， 返回 一 个 负 值 ， 
如 果 相 等 则 返回 0。 尽 管 实现 这 个 函数 的 最 显而易见 的 方法 是 只 对 这 两 个 项 目 做 一 
个 数字 的 比较 就 可 以 了 ， 但 是 这 并 不 唯一 的 排序 方法 。 上 比如 ， 数 据 项 可 能 是 外 部 字 
典 或 列表 中 的 一 个 关键 字 ， 与 该 关键 字 相 应 的 是 一 个 更 复杂 的 数据 项 ， 这 种 情况 
下 ， 你 可 以 通过 比较 与 该 关键 字 相 应 的 数据 项 来 排序 。 


使 用 mixin 类 进行 列 排序 


关于 对 一 个 列表 控件 进行 排序 的 常见 的 情 is ， 让 用 户 能 够 通过 在 报告 模式 的 列表 
的 任 一 列 上 进行 敲 击 来 根据 该 列 进行 排序 。 你 可 以 使 用 Se 机 制 来 实 
现 ， 但 是 它 在 保持 到 列 的 跟踪 方面 有 点 复杂 。 幸运 的 是 ， 一 个 名 

为 ColumnsorterMixin 的 wxPython 的 mixin 类 可 以 为 你 处 理 这 些 信息 ， 它 位 
于 wx.lib.mixins.listctrl 模块 中 。 图 13.5 显 示 了 使 用 该 mixin 类 对 列 进 

的 排序 。 





图 13.5 
ER 
wx.ListCtrl with ColumnSorterMixin Joke 


Request ID Summary Date 应 A 
817429 OS X wheel mouse 2003-10-03 14:05 
& 819559 weoxListCtrl column widths in wxLC ICON mode 2003-10-07 13:34 
[5846361 Wishlist - vixStabcT ext that takes fonts, colors, etc. 2003-11-20 21:1€ 
—1846362 Wishlist - Crossplatform woRichT ext Widget 2003-11-20 21:20 
846364 wxPostscriptOC with floating point coordinates 2003-11-20 21:27 
846363 Wishlist - Better wxString Formatting 2003-11-20 21:27 
846366 Wishlist - wxDbGetConnection retum value 2003-11-20 21:2: 
1846367 Less flicker when resizing a window 2003-11-20 21:24 
846368 wxTextarl - disable auto-scrolling 2003-11-20 21:25 





71846369 weird - auto-scrolling 2003-11-20 21:2€ 
846372 Hooks for standard remote events 2003-11-20 21:2; 


846370 wxDtal - dial widget 2003-11-20 21:2; 
1.9 846373 Scroling improvements 2003-11-20 21:2 
[5846374 wxToolBar - return tool at posibon 2003-11-20 21:26 
B 846375 woxGraphicsPath 2003-11-20 21:36 Figure 13.5 

11852379 wxGrid row/cal size limits 2003-12-01 15:4; The column sorter mixin in 
lk 855902 virtual window classes 2003-12-07 12:3¢ s " s 
i 863301 waTextCtrl - edit mode 2003-12-19 17:46 action—notice the arrow in 


th 363306 weGrid - Thaw/Freeze column/row 2003121917: * | the date column indicating 
= > 2 Sort direction 

















声明 这 个 mixin 就 和 Python 中 声明 任何 其 它 的 多 重 继承 一 样 ， 如 下 所 示 : 


import wx.lib.mixins.listctrl as listmix 


class ListCtrlPanel(wx.Panel, listmix.ColumnSorterMixin): 

def — init (self, parent, log): 

wx.Panel. (init (self, parent, -1, style-wx.WANTS CHARS) 

self.list = TestListCtrl(self, tID) 

self.itemDataMap - musicdata 
listmix.ColumnSorterMixin. init (self, 3) 


例 13.4 是 图 13.5 的 例子 代码 
例 13.4 使 用 mixin 对 一 个 报告 列表 进行 排序 


#!/usr/bin/python 

#-*- encoding:UTF-8 -*- 
import wx 

import wx.lib.mixins.listctrl 
import sys, glob, random 
import data 


class DemoFrame(wx.Frame, wx.lib.mixins.listctrl.ColumnSorterMix 
in) :# 多 重 继承 
def _ init (self): 
wx.Frame.__init__(self, None, -1, 
"wx.ListCtrl with ColumnSorterMixin", 
size-(600,400)) 


# load some images into an image list 

il = wx.ImageList(16,16, True) 

for name in glob.glob("smicon??.png"): 
bmp = wx.Bitmap(name, wx.BITMAP TYPE PNG) 
il max - il.Add(bmp) 


# add some arrows for the column sorter 
# 添加 箭头 到 图 像 列 表 
self.up = il.AddWithColourMask( 
wx.Bitmap("sm up.bmp", wx.BITMAP TYPE BMP), "blue") 
self.dn - il.AddWithColourMask( 
wx.Bitmap("sm down.bmp", wx.BITMAP TYPE BMP), "blue" 


# create the list control 
self.list - wx.ListCtrl(self, -1, style-wx.LC REPORT) 


4 assign the image list to it 
self.list.AssignImageList(il, wx.IMAGE LIST SMALL) 


# Add some columns 
for col, text in enumerate(data.columns): 
self.list.InsertColumn(col, text) 


# add the rows 
# 创建 数据 映射 
self.itemDataMap = {} 
for item in data.rows: 
index = self.list.InsertStringItem(sys.maxint, item[ 
0]) 
for col, text in enumerate(item[1:]): 
self.list.SetStringItem(index, col+i, text) 


# give each item a data value, and map it back to th 


# item values, for the column sorter 
self.list.SetItemData(index, index)# 关联 数据 和 映射 
self.itemDataMap[index] = item 


# give each item a random image 
img = random.randint(0, il max) 
self.list.SetItemImage(index, img, img) 


# set the width of the columns in various ways 
self.list.SetColumnwidth(0, 120) 
self.list.SetColumnWidth(1, wx.LIST AUTOSIZE) 
self.list.SetColumnWidth(2, wx.LIST AUTOSIZE) 
self.list.SetColumnWidth(3, wx.LIST AUTOSIZE USEHEADER) 


# initialize the column sorter 
wx.lib.mixins.listctrl.ColumnSorterMixin. init__(self, 
len(da 
ta.columns)) 


def GetListCtrl(self): 
return self.list 


def GetSortImages(self): 
return (self.dn, self.up) 


app - wx.PySimpleApp() 
frame = DemoFrame() 
frame.Show() 
app.MainLoop() 


为 了 使 用 该 mixin 工作 ， 你 需要 执行 下 面 的 东西 : 


1、 扩 展 自 ColumnSorterMixin 的 类 (这 里 是 DemoFrame ) 必须 有 一 个 名 
为 GetListctrl() 的 方法 ， 它 返回 实际 要 被 排序 的 列表 控件 。 该 方法 被 这 
个 mixin 用 来 得 到 控件 的 一 个 索引 。 


2、 在 扩展 自 ColumnSorterMixin 的 类 (这 里 是 DemoFrame ) 

的 init () 方法 中 ， 在 你 调用 columnSorterMixin 的 init () 方法 之 
前 ， 你 必须 创建 GetListctrl() 所 要 引用 的 列表 控件 。 

该 mixin 的 — init () 方法 要 求 一 个 代表 列表 控 ? MASH AIS? 3、 你 尺 
须 使 用 SetItemData() 为 列表 中 的 每 行 设置 一 个 唯一 的 数据 值 。 


4、 扩 展 自 ColumnSorterMixin 的 类 (这 里 是 DemoFrame ) 必须 有 一 个 名 

为 itemDataMap 的 属性 。 该 属性 必须 是 一 个 字典 。 字 典 中 的 关键 性 的 东西 是 

由 SetItemData() 设置 的 数据 值 。 这 些 值 是 你 想 用 来 对 每 列 进行 排序 的 值 的 一 个 
元 组 。 (典型 情况 下 ， 这 些 值 将 是 每 列 中 的 文本 ) 。 按 句 话 说，itemDataMap 本 
质 上 是 将 控件 中 的 数据 复制 成 另 一 种 易于 排序 的 形式 。 


在 ColumnSorterMixin 的 通常 用 法 中 ， 你 要 么 创建 itemDataMap 用 来 添加 项 目 
到 你 的 列表 控件 ， 要 么 你 首先 创建 itemDataMap ， 并 用 它 来 建造 列表 控件 本 身 。 


尽管 配置 可 能 有 点 复杂 ， 但 ColumnSorterMixin 对 于 列 的 排序 是 一 个 不 错 的 选 
择 。 


步 了 解 列 表 控 件 


有 时 候 ， 在 你 的 程序 中 的 某 处 你 需要 确定 列表 中 的 哪个 项 目 被 选择 了 ， 或 者 你 需要 
通过 编程 来 改变 当前 的 选择 以 响应 用 户 事 件 ， 或 其 它 发 生 在 你 的 程序 中 的 一 些 事 
情 。 


有 几 个 与 查找 列表 中 的 一 个 项 目的 索引 相关 的 方法 ， 它 们 提供 了 项 目的 一 些 信 息 ， 
如 表 13.7 所 示 。 


表 13.8 显 示 出 了 由 HitTest() 方法 返回 的 可 能 的 标记 。 实 际 应 用 中 ， 可 能 返回 不 
止 一 个 标记 。 


表 13.7 查找 列表 中 的 项 目的 方法 


查找 第 一 个 与 str 匹配 的 : 
FindItem(start, str, partial-False) 从 start 的 指定 的 索引 处 
符 囊 ， 而 非 完全 匹配 。 返 区 
查找 与 最 接近 位 置 点 poin 
FindItemAtPos(start * point, direction) 的 位 置 。 参 数 direction 
wx.LIST_FIND_DOWN, wx 


查找 项 目 数据 (4$ Setr 


FindItemData(start, data) Xt start F] FindIt () 
x start ^J Fin em 


i&wI—^*( index, flags) 
HitTest(point) de RAR PR EORR E > AL 
& flags 是 一 个 位 掩 码 


表 13.8 关于 HitTest() 方法 返回 值 中 的 标记 


wx.LIST_HITTEST_ABOVE 点 在 列表 的 客户 区 域 的 上 面 。 


A, 
置 点 在 列表 的 客户 区 域 的 下 面 。 
位 置 点 在 列表 的 客户 区 域 中 ， 但 不 
wx.LIST_HITTEST_NOWhere 属于 任何 项 目的 部 分 。 通 常 这 是 因 

为 它 是 在 列表 的 结尾 处 。 


位置 点 在 项 目的 矩形 区 域 中 ， 
wx.LIST HITTEST. ONITEM ; index, flags) 中 的 index 是 
该 项 目的 索引 。 


立 置 点 在 项 目的 图 标 区 域 中 ， 
wx. LIST_HITTEST_ONITEMICON d index, flags) 中 的 index 是 


该 项 目的 索引 。 
位 置 点 在 项 目的 标签 区 域 中 ， 


位 
位 


Was | 


wx.LIST_HITTEST_BELOW 


wx.LIST_HITTEST_ONITEMLABEL ( index, flags) 中 的 index 是 
该 项 目的 索引 。 
wx.LIST_HITTEST_ONITEMRIGHT 位 置 点 在 项 目 右 边 的 空白 区 域 中 。 


位 置 点 在 一 个 项 目的 状态 图 标 中 。 
wx. LIST_HITTEST_ONITEMSTATEICON E M 的 模式 ， 


并 且 存 在 一 个 用 户 定义 的 状态 。 
wx. LIST_HITTEST_TOLEFT 立 置 点 在 列表 的 客户 区 域 的 左 


wx.LIST_HITTEST_TORIGHT 位 置 点 在 列表 的 客户 区 域 的 右边 。 


至 于 其 它 的 方面 ， 还 有 几 个 方法 ， 它 们 将 为 你 提供 关于 所 指定 的 项 目 息 
方法 GetItem() 和 GetItemText() 方法 我 们 早先 已 说 过 了 ， 其 它 的 见 表 13.9 


表 13.9 获得 列表 控件 的 项 目 信 息 的 方法 


o 


GetItemPosition(item) 


GetItemRect (item, code= wx.LIST RECT BOUNDS) 


GetNextItem(item, geometry=wx.LIST_ALL, state=wx.LIST_STATE_DONTCA 


SetItemPosition(item, pos) 


表 13.10 列 出 了 用 于 GetNextItem() 的 geometry 参数 的 取 值 。 geometry 参数 
只 用 于 微软 Windows 下 。 


表 13.10 GetNextItem() 的 geometry 参数 的 取 值 


查找 显示 上 位 于 开始 项 目 之 上 的 下 一 个 为 指定 状态 
的 项 目 。 


在 列表 中 按 索 引 的 顺序 查找 下 一 个 为 指定 状态 的 项 
目 o 


查找 显示 上 位 于 开始 项 目 之 下 的 下 一 个 为 指定 状态 
的 项 目 。 


查找 显示 上 位 于 开始 项 目 左 边 的 下 一 个 为 指定 状态 
的 项 目 。 


查找 显示 上 位 于 开始 项 目 右边 的 下 一 个 为 指定 状态 
的 项 目 。 


wx.LIST_NEXT_ABOVE 
WX.LIST NEXT ALL 
WX.LIST NEXT BELOW 
WX.LIST NEXT LEFT 
WX.LIST NEXT RIGHT 


表 13.11 列 出 了 用 于 GetNextItem() 的 state 参数 的 取 值 


#13.11 用 于 GetNextItem() 的 state 参数 的 取 值 
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WX.LIST STATE DONTCARE 查找 项 目 ， 不 管 它 当 前 的 状态 。 


WX.LIST STATE CUT 


wx.LIST STATE DropHILITED 只 查找 鼠标 要 释放 的 项 目 。 
wx.LIST STATE FOCUSED 查找 当前 有 焦点 的 项 目 。 


WX.LIST STATE SelectED 只 查找 当前 被 选择 的 项 目 。 


表 13.12 显 示 了 用 于 改变 一 个 项 目的 文本 显示 的 方法 以 及 用 于 控件 项 目的 字体 和 磊 
色 的 方法 。 


表 13.2 列表 控件 的 显示 属性 


处 理 整个 列表 控件 的 背景 色 。 参 
GetBackgroundColour() it col 是 一 个 T KA 


色 名 。 
SetBackgroundColour (col) 


Ab 38 4e 5] item 所 指定 的 项 目的 
Get ItemBackgroundColour (item) 背景 色 。 这 个 属性 只 用 于 报告 模 


x 
SetItemBackgroundColour(item,col) 


Ab 3E RG item 所 指定 的 项 目的 


GetItemTextColour(item) 文本 的 颜色 。 这 个 属性 只 用 于 报 
告 模式 。 

SetItemTextColour(item, col) 

GetTextColour() 处 理 整 个 列表 的 文本 的 颜色 。 

SetTextColour(col) 


表 13.3 显 示 了 列表 控件 的 其 它 的 一 些 方法 。 
表 13.3 列表 控件 的 其 它 的 一 些 方法 


返回 位 于 图 标 间 的 空白 人 EF 
GetItemSpacing() 返回 位 于 图 标 间 的 空白 的 wx.Size 。 单 位 为 


像素 。 
GetSelectedItemCount() 返回 列表 中 当前 被 选择 的 项 目的 数量 。 

i " 或 ig d : oN 告 模 
Getroprtemo) p eed 的 项 目的 索引 。 只 在 报告 模 

返回 一 个 wx.Rect ， as 包含 所 有 项 目 
GetViewRect() 所 需 的 最 小 矩形 (没有 滚动 条 ) 。 只 对 图 标 或 


小 图 标 模 式 有 意义 。 


使 用 控件 滚动 。 参 数 dy CHAS? dx 是 水 
平 量 ， 单 位 是 像素 。 对 于 图 标 、 人 小 图 标 或 报告 
模式 ， 单 位 是 像素 。 如 果 有 是 列表 模式 ， 那 么 单 
位 是 列 数 。 


Scerollkist(dx; dy) 


上 面 的 这 些 表 涉及 了 一 个 列表 控件 的 大 多 数 功能 。 然 而 到 目前 为 止 ， 我 们 所 见 过 的 
所 有 的 列表 控件 ， 它 们 被 限制 为 : 在 程序 的 运行 期 间 ， 它 们 的 所 有 数据 必须 存在 于 
内 存 中 。 在 下 一 节 ， 我 们 将 讨论 一 个 机 制 ， 这 个 机 制 仅 在 数据 需要 被 显示 时 ， 才 提 
供 列表 数据 。 


创建 一 个 庶 列 表 控 件 


让 我 们 设想 你 的 wxPython 应 用 程序 需要 去 显示 包含 你 所 有 客户 的 一 个 列表 。 开 始 
时 你 使 用 一 个 标准 的 列表 控件 ， 并 且 它 工作 的 很 好 。 后 来 人 的 客户 列表 变 得 越 来 越 
大 ， 太 多 的 客户 使 得 你 的 应 用 程序 开始 出 现 了 效率 问题 。 这 时 你 的 程序 起 动 所 需 的 
时 间 变 得 较 长 了 ， 并 占用 越 来 越 多 的 内 存 。 你 怎么 办 呢 ? 你 可 以 创建 一 个 虚 的 列表 
控件 。 


问题 的 实质 就 是 列表 控件 的 数据 处 理 。 通 常 ， 这 些 数 据 都 是 从 数据 产生 的 地 方 将 数 
据 拷贝 到 列表 控件 中 。 这 是 潜在 地 浪费 资源 ， 对 于 一 个 小 的 列表 ， 这 好 象 看 不 出 任 
何 问题 ， 但 对 于 创建 一 个 较 大 的 列表 控件 ， 这 将 占用 很 多 的 内 存 ， 并 导致 启动 变 
te o 

为 了 将 一 个 列表 控件 所 占 的 内 存 和 启动 所 需 的 时 间 降 到 最 小 化 ，wxPython 允许 你 
去 声明 一 个 虚 的 列表 控件 ， 这 意味 关于 每 项 的 信息 只 在 控件 需要 去 显示 该 项 时 才 生 
成 。 这 就 防止 了 控件 一 开始 就 将 每 项 存储 到 它 的 内 存 空间 中 ， 并 且 这 也 意味 着 在 启 
动 时 ， 并 没有 声明 完整 的 列表 控件 。 同 时 这 个 方案 的 缺点 就 是 庶 列 表 中 的 列表 项 的 
恢复 可 能 变 得 较 慢 。 图 13.6 显 示 了 一 个 虚 列 表 。 


例 13.5 显 示 了 产生 该 庶 列 表 控 件 的 完整 代码 
图 13.6 
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Figure 13.6 
A virtual list control 














#!/usr/bin/python 

#-*- encoding:UTF-8 -*- 
import wx 

import sys, glob, random 
import data 


class DataSource: #24 7$. 


A simple data source class that just uses our sample data items 


A real data source class would manage fetching items from a 
database o similar. 
def GetColumnHeaders(self): 
return data.columns 


def GetCount(self): 
return len(data.rows) 


def GetItem(self, index): 
return data. rows[ index ] 


def UpdateCache(self, start, end): 
pass 


class VirtuallistCtrl(wx.ListCtrl):41 声明 庶 列 表 


A generic virtual listctrl that fetches data from a DataSource. 
def _ init__(self, parent, dataSource): 
wx.ListCtrl. init (self, parent, 
style-wx.LC REPORT|wx.LC SINGLE SEL |wx.LC VIRTUAL )# 
使 用 wx .LC_VIRTUAL 标 记 创 建 虚 列 表 
self.dataSource = dataSource 
self.Bind(wx.EVT LIST CACHE HINT, self.DoCacheItems) 
self.SetItemCount(dataSource.GetCount ( ) )# 设 置 列 表 的 大 小 


columns = dataSource.GetColumnHeaders() 
for col, text in enumerate(columns): 
self.InsertColumn(col, text) 


def DoCacheItems(self, evt): 
self .dataSource.UpdateCache( 
evt.GetCacheFrom(), evt.GetCacheTo()) 


def OnGetItemText(self, item, col) :# 得 到 需求 时 的 文本 
data = self.dataSource.GetItem(item) 
return data[col] 


def OnGetItemAttr(self, item): return None 
def OnGetItemImage(self, item): return -1 


class DemoFrame(wx.Frame): 
def — init (self): 
wx.Frame. (init (self, None, -1, 
"Virtual wx.ListCtrl", 
size-(600,400)) 


self.list = VirtualListCtrl(self, DataSource()) 


app - wx.PySimpleApp() 
frame = DemoFrame() 
frame.Show() 
app.MainLoop() 


这 个 数据 源 的 类 是 一 个 简单 的 例子 ， 它 存储 了 我 们 所 需要 的 数据 项 。 站 实情 况 下 的 
数据 源 类 还 会 处 理 从 一 个 数据 库 中 获取 数据 之 类 的 情况 ， 这 种 情况 下 只 需要 重新 实 
现 本 例 中 的 同一 接口 。 


要 创建 一 个 虚 列 表 ， 第 一 步 就 是 在 初始 化 的 时 候 对 列表 控件 使 

用 wx.LC VIRTUAL 标记 如 #1。 通 常 使 用 子 类 wx .Listctrl 来 创建 你 的 虚 列 表 控 
件 ， 而 非 仅仅 使 用 构造 函数 。 这 是 因为 你 需要 徐 盖 wx.Listctrl 的 一 些 方法 ， 以 
便 扩 展 这 个 虚 列 表 。 虚 列表 的 声明 类 似 如 下 : 


class MyVirtualList(wx.ListCtr1l): 

def _ init (self, parent): 
wx.ListCtrl. init (self, parent, -1, 
style-wx.LC REPORT |wx.LC VIRTUAL) 


有 时 在 虚 列 表 的 初始 化 期 间 ， 必 须 调用 SetrtemCount() 方法 。 这 将 告诉 控件 在 
数据 源 中 存在 多 少数 据 项 ， 这 样 它 就 可 以 设置 适当 的 限制 并 处 理 滚动 条 。 如 果 数 据 
源 中 的 数据 项 的 数量 改变 了 ， 你 可 以 再 调用 SetItemCount() 一 次 。 你 所 履 盖 的 
任何 以 On 开关 的 方法 ， 必 须 能 够 处 理 [0，SetItemCcount() 一 们 间 的 数据 。 


你 的 虚 列 表 控 件 可 以 覆盖 其 父 类 的 三 个 方法 ， 以 便 决定 在 列表 控件 中 显示 些 什么 。 
最 重要 的 要 履 盖 的 方法 是 OnGetItemText(item，col) 。 其 中 的 参 

数 item 和 col 是 要 绘制 的 单元 格 的 行 和 列 ， 方 法 的 返回 值 是 显示 在 该 单元 格 中 
的 文本 字符 串 。 例 如 ， 下 面 的 方法 将 只 显示 相关 单元 格 的 坐标 。 


def OnGetItemText(self, item, col): 
return "Item %d, column %d" % (item, col) 


如 果 你 想 在 一 行 中 显示 一 个 图 像 ， 你 需要 复 盖 OnGetItemImage(item) 。 它 的 返 

回 值 是 较 早 声明 的 列表 控件 的 图 像 列 中 的 一 个 整数 索引 。 如 果 你 没有 覆盖 这 个 方 

法 ， 那 么 基 类 版 本 的 OnGetItemImage 将 返回 一 1， 这 表明 不 显示 图 像 。 如 果 你 想 
改变 行 的 一 些 显示 属性 ， 那 么 你 可 以 覆盖 OnGetItemAttr(item) 方法 ， item X 
行 的 索引 ， 该 方法 返回 类 wx.ListItemAttr 的 一 个 实例 。 该 类 有 一 

些 get 和 set 方法 可 以 用 来 设置 行 的 颜色 、 对 齐 方式 等 等 显示 属性 。 


如 果 你 的 虚 列 表 所 基于 的 数据 改变 了 ， 而 你 想 更 新 显示 ， 那 么 你 可 以 使 用 该 列表 控 
件 的 RefreshItem(item) 来 重 绘 特定 的 行 。 相 关 的 方 

ik RefreshItems(itemFrom,itemTo) 重 绘 位 于 索引 itemFrom 和 itemTo 间 的 
所 有 行 。 


为 了 对 数据 源 中 的 数据 的 获取 提供 优化 帮助 ， 对 于 要 显示 一 页 新 的 数据 ， 虚 列表 控 
件 会 发 送 EVT LIST CACHE HINT 事件 。 这 将 给 你 的 数据 源 一 个 时 机 用 以 从 数据 库 
(或 另 处 ) 一 次 获取 几 个 记录 并 保存 它们 。 这 样 就 使 得 随后 

的 OnGetItemText() 执行 的 更 快 。 


本 草 小 结 


1、 列 表 控 件 是 wxPython 用 于 显示 列表 信息 的 窗口 部 件 。 它 比 简单 的 列表 框 部 件 
要 更 复杂 且 有 完整 的 特性 。 列 表 控 件 是 类 wx.Listctrl 的 实例 。 列 表 控 件 可 以 显 
示 为 图 标 模 式 ， 每 个 图 标 下 都 有 一 个 项 目 文本 ， 也 可 以 显示 为 带 有 小 图 标的 小 图 标 
模式 等 等 。 在 列表 模式 中 ， 元 素 按 列 显示 ， 在 报告 模式 中 ， 以 多 列 的 格式 显示 列 
表 ， 每 列 都 有 列 标签 。 


2、 用 于 列表 控件 的 图 像 是 由 一 个 图 像 列表 管理 的 ， 图 像 列表 是 一 个 可 经 由 索引 来 
访问 的 一 个 图 像 的 数组 。 列 表 控 件 可 以 为 不 同 的 列表 模式 维护 各 自 的 图 像 列表 ， 这 
使 得 能 够 容易 地 在 模式 间 切 换 。 


3、 你 可 以 使 用 InsertStringItem(index, label) 方法 来 插入 文本 到 列表 中 ， 使 
用 InsertImageItem(index, imageIndex) 方法 插入 图 像 到 列表 中 。 要 一 次 做 上 
面 两 件 事 ， 可 以 使 用 InsertImageStringItem(index, label, 


e imageIndex) 。 要 对 报告 模式 的 列表 添加 列 ， 可 以 使 
用 InsertColumn(col, heading, format= " wx.LIST_FORMAT_LEFT, widt 
-1) 方 法 。 一 旦 已 经 添加 了 列 后 ， 你 就 可 以 使 
用 SetStringItem(index, col, label, imageId- -1) 方 法 为 新 的 列 增加 文 
ke 


4、 列 表 控 件 产生 的 几 个 事件 可 以 被 绑 到 程序 的 动作 。 这 些 事件 项 属于 
类 wx.ListEvent 。 通 常 的 事件 类 型 包 
括 EVT_LIST_Insert_ITEM，EVT_LIST_ITEM_ACTIVATED， 和 EVT LIST ITEM_ 


o 





5、 如 果 列 表 控 件 声 明 时 使 用 了 wx.LC EDIT LABELS 标记 ， 那 么 用 户 就 可 以 编辑 
列表 项 的 文本 。 编 辑 的 确认 是 通过 按 下 回 车 键 或 在 列表 中 斋 击 完成 的 ， 也 可 以 通过 
按 下 Esc 键 来 取消 编辑 。 


6、 你 可 以 通过 在 声明 列表 时 使 

用 wx.LC_SORT_ASCENDING 或 wx.LC_SORT_DESCENDING 来 排序 列表 。 这 将 按照 
项 目的 字符 串 的 顺序 来 排序 列表 。 在 报告 模式 中 ， 这 将 根据 0 列 的 字符 串 来 排序 。 
你 也 可 以 使 用 SortItems(func) 方法 来 创建 你 自 定义 的 排序 方法 。 对 于 报告 模式 
的 列表 ， mixin 类 wx.lib.mixins.listctrl.ColumnSorterMixin 给 了 你 根据 
用 户 所 选择 的 列 来 排序 的 能 力 。 


7、 使 用 了 标记 wx.LC VIRTUAL 声明 的 列表 控件 是 一 个 虚 列 表 控 件 。 这 意味 着 它 
的 数据 是 当 列 表 中 的 项 目 被 显示 时 动态 地 确定 的 。 对 于 虚 列 表 控 件 ， 你 必须 履 

ii OnGetItemText(item, col) 方法 以 返回 适当 的 文本 给 所 显示 的 行 和 列 。 你 也 
可 以 使 用 OnGetItemImage(item) 和 OnGetItemAttr(item) 方法 来 返回 关于 每 
行 的 图 像 或 列表 的 显示 属性 。 如 果 数 据 源 的 数据 改变 了 ， 你 可 以 使 

用 RefreshItem(item) 方法 来 更 新 列表 的 某 个 行 或 使 

用 RefreshItems(itemFrom, itemTo) 方法 来 更 新 多 个 行 。 


最 终 ， 你 的 数据 将 变 得 复杂 得 不 能 放 在 一 个 简单 的 列表 中 。 你 将 会 需要 类 似 二 维 的 
电子 表格 样式 的 东西 ， 这 就 是 网 格 控件 ， 我 们 将 在 下 一 章 进行 讨论 。 


C 


`~ 


第 十 四 章 网 格 控件 


本 章 内 容 包 括 : 
e 创建 网 格 ( grid) 
e. 添加 行 和 单元 格 ( cel11)， 并 且 处 理 列 的 首部 
e 使 用 一 个 自 定 义 的 单元 格 ( cell) 描绘 器 ( renderer) 
e 创建 自 定 义 的 编辑 器 
e 捕获 用 户 事 件 


网 格 控件 大 概 是 wxPython 中 最 复杂 和 最 灵活 的 一 个 窗口 部 件 。 在 这 一 章 ， 你 将 有 
机 会 接触 到 这 个 控件 的 许多 特性 。 我 们 将 讨论 如 何 输入 数据 到 网 格 控件 以 及 如 何 处 
理 该 控件 的 显示 属性 ， 并 且 我 们 还 将 讨论 自 定义 编辑 器 和 描绘 器 。 网 格 控 件 使 你 能 
够 在 一 个 类 似 电子 表格 格式 的 网 格 中 显示 表格 数据 。 该 控件 允许 你 为 行 和 列 指定 标 
签 ， 以 及 通过 拖 动 网 格 线 来 改变 网 格 的 大 小 ， 并 且 可 以 为 每 个 单元 格 单独 指定 字体 
和 颜色 属性 。 


在 最 常见 的 情况 下 ， 你 一 般 会 显示 一 个 简单 的 字符 囊 值 。 然 而 ， 你 也 能 为 任 一 单元 
格 指 定 一 个 自 定义 的 描绘 器 ， 以 使 你 能 够 显示 不 同 的 数据 ; 你 可 以 有 编辑 表 中 的 单 
元 格 ， 并 且 对 不 同 的 数据 使 用 不 同类 型 的 编辑 器 。 你 还 能 够 创建 你 自己 自 定义 的 描 
绘 器 和 编辑 器 ， 这 使 得 你 在 单元 格 数据 的 显示 和 处 理 上 可 以 非常 的 灵活 ， 几 乎 没有 
什么 限制 。 网 格 控件 还 有 大 量 的 鼠标 和 键盘 事件 ， 你 可 以 程序 中 捕获 它们 并 用 来 触 
发 相关 的 代码 o 


我 们 将 通过 展示 两 个 创建 wxPython 网 格 的 方法 来 作为 我 们 讨论 的 开始 。 


创建 你 的 网 格 


网 格 控 件 是 用 以 显示 一 个 二 维 的 数据 集 的 。 要 使 用 该 控件 显示 有 用 的 信息 ， 你 需要 
告诉 该 控件 它 工作 所 基于 的 是 什么 数据 。 在 wxPython 中 ， 有 两 种 不 同 的 机 制 用 于 
在 网 格 控件 中 处 理 数据 ， 它 们 之 间 在 处 理 数据 的 添加 ， 删 除 和 编辑 的 方式 上 有 些许 
的 不 同 。 


e 网 格 控件 可 以 直接 处 理 每 行 和 每 列 中 的 值 。 
e 数据 可 以 通过 使 用 一 个 网 格 表 ( grid table) 来 间接 地 处 理 。 


较 简单 的 一 种 是 使 用 网 格 控件 直接 处 理 值 。 在 这 种 情况 下 ， 网 格 维护 着 数据 的 一 份 
捞 贝 。 在 这 种 情况 下 ， 如 果 有 大 量 的 数据 或 你 的 应 用 程序 已 经 有 了 一 个 现存 的 网 格 
类 的 数据 结构 ， 那 么 这 可 能 显得 比较 策 抽 。 如 果 是 这 样 ， 你 可 以 使 用 一 个 网 格 表 来 
处 理 该 网 格 的 数据 。 参 见 第 5 章 来 回顾 一 下 在 MVC 架构 中 ， 网 格 表 是 如 何 被 作为 一 
个 模型 的 。 


如 何 创建 一 个 简单 的 网 格 ? 


尽管 网 格 控件 有 大 量 的 方法 用 于 控件 精确 的 显示 和 数据 的 管理 ， 但 时 开始 使 用 一 个 
网 格 控件 是 十 分 简单 的 。 图 14.1 显 示 了 一 个 简单 的 网 格 ， 其 中 的 单元 格 中 添加 了 一 
些 字符 串 数 据 。 


图 14.1 
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网 格 控件 是 类 wx.grid.Grid 的 实例 。 由 于 网 格 类 及 相关 类 的 尺寸 的 原因 ， 实 际 
FS AE AAR Ie o a eA ET VHITH COMER o ENT 
会 被 自动 导入 到 核心 的 名 字 空 间 中 。 wx.grid.Grid 的 构造 函数 类 似 于 其 它 的 控 
件 的 构造 函数 。 


wx.grid.Grid(parent, id, pos=wx.DefaultPosition, 
size=wx.DefaultSize, style=wx.WANTS_CHARS, 
name=wxPanelNameStr ) 


其 中 的 所 有 的 参数 与 wx.Window 的 构造 函数 是 相同 的 ， 并 且 有 相同 的 意 

义 。 wx.WANTS_CHARS 样式 是 网 格 的 默认 样式 ， 除 此 之 外 ， wx.grid.Grid 没有 
为 自己 定义 特别 的 样式 。 由 于 网 格 类 的 复杂 性 ， 所 以 在 程序 中 ， 你 一 般 要 自 定 义 网 
格 类 的 一 个 子 类 来 实现 一 个 网 格 ， 而 非 直接 使 用 wx.grid.Grid 的 一 个 实例 。 


和 我 们 所 见 过 的 别 的 控件 不 同 ， 调 用 该 构造 函数 不 足以 创建 一 个 可 用 的 网 格 。 有 两 
个 方法 用 以 初始 化 网 格 


e CreateGrid() * SetTable() 
在 这 一 节 ， 我 们 将 讨论 一 个 方法 ， 第 二 个 方法 将 在 网 格 表 的 讨论 中 提 及 。 


要 显 式 地 初始 化 网 格 ， 可 以 使 用 方 
法 CIS ECOL uo numCols, selmode-wx.grid.Grid.SelectCells) ° 
这 个 方法 应 该 在 构造 函数 之 后 被 直接 地 调用 ， ， 并 用 必须 在 网 格 被 显示 之 前 调用 。 参 


žk numRows, numCols 指定 了 网 格 的 初始 大 小 。 参 数 selmode 指定 了 网 格 中 单元 
格 的 选择 模式 ， 默 认 值 是 wx.grid.Grid.SelectCells ， 意 思 是 一 次 只 选择 一 个 
单元 格 。 其 它 的 值 有 wx.grid.Grid.SelectRows ， 意 思 是 一 次 选择 整个 

行 ， wx.grid.Grid.SelectionColumns ， 意 思 是 一 次 选择 整个 列 。 创 建 之 后 ， 
你 可 以 使 用 方法 GetSelectionMode() 来 访问 选择 模式 ， 并 且 你 可 以 使 用 方 

法 SetSelectionMode(mode) 来 重 置 模式 。 你 还 可 以 使 用 方 

法 GetNumberCols() 和 GetNumberRows() 来 得 到 行 和 列 数 。 


在 内 部 ， 使 用 CreateGrid() 初始 化 网 格 之 后 ， wxPython 设置 了 一 个 二 维 的 字 
符 囊 数组 。 一 旦 网 格 被 初始 化 了 ， 你 就 可 以 使 用 方 

法 SetCellvalue(row, col, s) 来 放置 数据 。 其 中 参数 row, col 是 要 设置 的 
单元 格 的 坐标 ，S 是 要 在 该 坐标 处 显示 的 字符 囊 文 本 。 如 果 你 想 获取 特定 坐标 处 的 
值 ， 你 可 以 使 用 函数 GetCellvalue(row, col) ， 该 函数 返回 字符 串 。 要 一 次 清 
空 整个 网 格 ， 你 可 以 使 用 方法 ClearGrid() 。 例 14.1 显 示 了 产生 图 14.1 的 代码 。 


例 14.1 使 用 ClearGrid() 创建 的 一 个 示例 网 格 


import wx 
import wx.grid 


class TestFrame(wx.Frame): 
def _ init (self): 
wx.Frame.__init__(self, None, title="Simple Grid", 
size=(640, 480) ) 
grid = wx.grid.Grid(self) 
grid.CreateGrid(50,50) 
for row in range(20): 
for col in range(6): 
grid.SetCellValue(row, col, 
"cell (%d,%d)" % (row, col)) 


app = wx.PySimpleApp( ) 
frame = TestFrame() 
frame.Show() 
app.MainLoop() 


CreateGrid() 和 Setcellvalue() 仅 限 于 你 的 网 格 数据 是 由 简单 字符 串 组 成 的 
情况 。 如 果 你 的 数据 更 加 的 复杂 或 表 特 别 大 的 话 ， 更 好 的 方法 是 创建 一 个 网 格 表 ， 
这 将 随后 讨论 。 


如 何 使 用 网 格 表 来 创建 一 个 网 格 ? 


对 于 较 复 杂 的 情况 ， 你 可 以 将 你 的 数据 保存 在 一 个 网 格 表 中 ， 网 格 表 是 一 个 单独 的 
类 ， 它 存储 数据 并 与 网 格 控件 交互 以 显示 数据 。 推 荐 在 下 列 情况 下 使 用 网 格 表 : 


e 网 格 的 数据 比较 复杂 数据 存储 在 你 的 系统 中 的 另外 的 对 象 中 网 格 太 大 以 致 于 
不 能 一 次 整个 被 存储 到 内 存 中 


在 第 5 章 中 ， 我 们 在 MVC 设计 模式 中 讨论 了 网 格 表 以 及 在 你 的 应 用 程序 中 实现 一 个 
网 格 表 的 不 同方 法 。 在 本 章 ， 我 们 将 重点 放 在 对 网 格 表 的 使 用 上 。 图 14.2 显 示 了 使 
用 网 格 表 创 建 的 一 个 网 格 。 


图 14.2 
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要 使 用 一 个 网 格 表 ， 你 需要 要 创建 wx.grid.PyGridTableBase 的 子 类 。 该 子 类 必 
RH GLH wx.grid.GridTableBase 的 一 些 方法 。 例 14.2 显 示 了 用 于 创建 图 14.2 
的 代码 o 


例 14.2 关于 使 用 网 格 表 机 制 的 代码 























#-*- encoding:UTF-8 -*- 
import wx 
import wx.grid 


class TestTable(wx.grid.PyGridTableBase):Z€ LABR 
def — init (self): 
wx.grid. Rp d at __ init__(self) 
self.data = { (1,1) "Here", 
(2322) S 


(3,3) : "some", 
(4,4) data 
} 


self .odd=wx.grid.GridCellAttr() 
self .odd.SetBackgroundColour("sky blue") 
self.odd.SetFont(wx.Font(10, wx.SWISS, wx.NORMAL, wx.BOL 


D)) 


self .even=wx.grid.GridCellAttr() 

self.even.SetBackgroundColour("sea green") 

self.even.SetFont(wx.Font(10, wx.SWISS, wx.NORMAL, wx.BO 
LD)) 


# these five are the required methods 
def GetNumberRows( self): 
return 50 


def GetNumberCols(self): 
return 50 


def IsEmptyCell(self, row, col): 
return self.data.get((row, col)) is not None 


def GetValue(self, row, col):#A M iiti XE 
value - self.data.get((row, col)) 
if value is not None: 
return value 
else: 
return '' 


def SetValue(self, row, col, value):425 & Nul 
self.data[(row,col)] = value 


# the table can also provide the attribute for each cell 
def GetAttr(self, row, col, kind): 

attr = [self.even, self.odd][row % 2] 

attr.IncRef() 

return attr 


class TestFrame(wx.Frame): 
def — init (self): 
wx.Frame. init__(self, None, title="Grid Table", 
size=(640, 480) ) 


grid = wx.grid.Grid(self) 


table = TestTable() 
grid.SetTable(table, True) 


app = wx.PySimpleApp() 
frame = TestFrame() 
frame. Show( ) 

app .MainLoop( ) 


在 例 14.2 中 ， 所 有 特定 于 应 用 程序 的 逻辑 都 已 被 移 到 了 网 格 表 类 ， 所 以 这 里 就 没有 
必须 创建 一 个 自 定 义 的 wx.grid.Grid 的 子 类 。 


要 使 网 格 表 有 效 ， 你 必须 履 盖 5 个 方法 。 表 14.1 列 出 了 这 些 方法 。 在 这 一 章 中 ， 我 
们 还 会 看 到 其 它 你 能 履 盖 的 方法 ， 你 可 以 履 盖 它们 以 给 于 你 的 表 更 多 的 功能 。 


表 14.1 wx.grid.GridTableBase 中 需要 被 覆盖 的 方法 


GetNumberCols() 返回 显示 在 网 格 中 的 列 的 数目 
GetNumberRows( ) 返回 显示 在 网 格 中 的 行 的 数目 
回 坐 标 ( row, col) 处 的 值 


如 果 坐 标 ( row, col) 处 的 单元 格 为 空 的 话 ， 
返回 True ° GMA False 。 


GetValue(row, col) iR 


IsEmptyCell(row, col) 


SetValue(row, col, value) : 如 果 你 需要 的 话 ， 它 使 你 能 够 更 新 你 底层 的 数 
据 结 构 以 匹配 用 户 的 编辑 。 对 于 一 个 只 读 的 表 ， 你 仍然 需要 声明 该 方法 ， 但 是 你 可 
以 通过 pass 来 使 它 什 么 也 不 做 。 该 方法 在 当 用 户 编辑 一 个 单元 格 时 自动 被 调用 。 


要 将 网 格 表 实例 附着 于 你 的 表 的 实例 ， 要 调用 

SetTable( table, takeOwnership=False, selmode=wx.grid.Grid.SelectCells 
方法 。 其 中 参数 table 是 你 的 wx.grid.PyGridTableBase 的 实例 。 参 

数 takeOwnership 使 得 网 格 控件 拥有 这 个 表 。 如 果 takeOwnership 为 True ° 
那么 当 网 格 被 删除 时 ， 该 表 也 被 wxPython 系统 删除 。 参 数 selmode 作用 等 同 于 
在 CreateGrid() 中 的 作用 。 


还 有 一 些 其 它 的 方法 你 可 以 窗 盖 ， 以 处 理 网 格 的 各 部 分 ， 而 非 表 的 数据 。 在 本 章 的 
稍 后 部 分 ， 我 们 将 讨论 这 些 方法 中 的 一 些 。 并 且 ， 我 们 将 看 到 在 某 些 情况 中 ， 使 
用 setTable 创建 的 表 的 行为 与 使 用 CreateGrid() 创建 的 表 的 行为 是 不 同 的 。 


你 能 够 覆盖 的 另 一 个 方法 是 Clear() ， 它 在 当 对 网 格调 用 ClearGrid() 时 被 调 
用 ， 如 果 适 当 的 话 ， 你 可 以 履 盖 该 方法 来 清除 潜在 的 数据 源 。 在 网 格 中 置 入 数据 了 
以 后 ， 你 现在 可 以 开始 对 网 格 作 各 种 有 兴趣 的 事情 了 。 在 下 一 节 ， 我 们 将 给 你 展示 
如 何 处 理 网 格 的 外 观 。 


使 用 网 格 工作 


一 旦 网 格 被 创建 并 初始 化 了 ， 你 就 可 以 用 很 多 不 同 的 方法 来 处 理 它 了 。 单 元 格 、 行 
或 列 可 以 被 添加 和 删除 。 你 可 以 增加 首部 ， 改 变 一 行 或 一 列 的 大 小 ， 并 可 以 用 代码 
的 方式 来 改变 网 格 的 可 见 部 分 或 被 选择 的 部 分 。 下 面 的 几 节 ， 我 们 将 涉及 这 些 内 
X o 


如 何 添加 、 删 除 行 ， 列 和 单元 格 ? 


在 网 格 被 创建 之 后 ， 你 仍然 可 以 添加 新 的 行 和 列 。 注 意 ， 依 据 网 格 的 创建 方法 不 
同 ， 该 机 制 的 工作 也 不 同 。 你 可 以 使 用 AppendCols(numCols=1) 方法 在 你 的 网 格 
的 右边 增加 一 列 。 使 用 AppendRows(numRows=1) 在 网 格 的 底部 增加 一 行 。 


如 果 不 是 想 在 网 格 的 行 或 列 的 最 后 添加 一 行 或 一 列 ， 你 可 以 使 用 方 

法 InsertCols(pos=0, numCols=1) 或 InsertRows(pos=1, numRows=1) 来 在 
指定 位 置 添加 。 其 中 参数 pos 代表 被 添加 的 新 元 素 中 第 一 个 的 索引 。 如 果 参 

数 numRows 或 numCols 大 于 1， 那 么 有 更 多 的 元 素 被 添加 到 起 始 位 置 的 右边 
(对 于 列 来 说 ) ， 或 起 始 位 置 的 下 边 (对 于 行 来 说 ) 。 


要 删除 一 行 或 一 列 ， 你 可 以 使 用 方 
法 DeleteCols(pos=0, numCols-1) 和 DeleteRows(pos=0, numRows=1) 。 其 
中 参数 pos 是 要 被 删除 的 行 或 列 的 第 一 个 的 索引 。 


如 果 网 格 是 使 用 CreateGrid() 方法 被 初始 化 的 ， 那 么 上 面 讨 论 的 方法 总 是 可 以 
工作 的 ， 并 且 在 新 的 行 或 列 中 创建 的 单元 格 是 以 一 个 空 字符 串 从 为 初始 值 的 。 如 果 
网 是 使 用 SetTable() 方法 被 初始 化 的 ， 那 么 网 格 表 必须 支持 对 表 的 改变 。 


要 支持 改变 ， 你 的 网 格 表 要 对 同样 的 改变 方法 进行 覆盖 。 例 如 ， 如 果 你 对 你 的 网 格 
调用 了 InsertCols() 方法 ， 那 么 网 格 表 也 必须 声明 一 

个 InsertCols(pos=0, numCols=1) 方法 。 该 网 格 表 的 这 个 方法 返回 布尔 

值 True 表示 支持 改变 ， 返 回 False 则 否决 改变 。 例 如 ， 要 创建 一 个 只 允许 被 扩 
展 到 50 行 的 一 个 表 ， 可 以 在 你 的 网 格 表 中 写 上 下 面 的 方法 。 


def AppendRows(self, numRows=1): 
return (self.GetRowCount() + numRows) = 50 


某 些 对 网 格 的 改变 不 会 立即 被 显示 出 来 ， 而 是 要 等 待 网 格 被 刷新 。 你 可 能 通过 使 
用 ForceRefresh() 方法 来 触发 一 个 即时 的 刷新 。 在 通常 情况 下 ， 如 果 你 用 代码 
的 方式 来 改变 你 的 网 格 ， 则 改变 不 会 立即 显示 出 来 ， 那 么 插入 

对 ForceRefresh() 方法 的 调用 可 以 确保 你 的 改变 即时 的 显示 出 来 。 


如 果 你 在 对 一 个 网 格 作 一 个 大 量 的 改变 ， 而 你 在 改变 期 间 不 想 让 网 格 的 显示 产生 闪 
烁 的 话 ， 你 可 以 通过 使 用 BeginBatch() 方法 来 告诉 该 网 格 去 作 一 个 批量 的 处 

理 。 该 方法 将 针对 网 格 作 一 个 内 在 的 增 量 计数 。 你 也 必须 在 批量 的 任务 之 后 调 

用 EndBatch() 该 方法 针对 网 格 作 一 个 内 在 的 减 量 计 数 。 当 计数 值 比 0 大 时 ， 
表明 正 处 于 开始 和 结束 计数 之 间 ， 网 格 这 时 不 会 重 绘 。 如 果 必 要 的 话 ， 你 还 可 以 在 
批量 处 理 中 再 秦 套 批量 处 理 。 同 样 ， 在 全 部 的 批量 处 理 没 有 完成 时 ， 网 格 不 会 重 


绘 。 





如 何 处 理 一 个 网 格 的 行 和 列 的 首部 ? 


在 一 个 wxPython 的 网 格 控件 中 ， 每 行 和 每 列 都 有 它们 自己 的 标签 。 默 认 情 况 下 ， 
行 的 标签 是 数字 ， 从 1 开 去 。 列 的 标签 是 字母 ， 从 A 开 始 。 wxPython 提供 了 一 些 
方法 来 改变 这 些 标签 。 图 14.3 显 示 了 一 个 带 有 首部 标签 的 网 格 。 


图 14.3 
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例子 14.3 显 示 了 产生 图 14.3 的 代码 。 其 中 网 格 是 用 CreateGrid() 初始 化 的 。 


$114.3 带 自 定 义 标 签 的 一 个 非 模 式 的 网 格 


import wx 
import wx.grid 


class TestFrame(wx.Frame): 


TEUN d dose tnes cest pol c CnCO 人 
["homer", "marge", "bart", "lisa", "maggie"] 


rowLabels 
colLabels 


def — init (self): 
wx.Frame. init (self, None, title="Grid Headers", 
size=(500, 200) ) 
grid = wx.grid.Grid(self ) 
grid.CreateGrid(5,5) 
for row in range(5): 
#1 start 
grid.SetRowLabelValue(row, self.rowLabels[row] ) 
grid.SetColLabelValue(row, self.colLabels[row] ) 
#1 end 
for col in range(5): 
grid.SetCellValue(row, col, 
"(%S,%S)" 96 (self.rowLabels[row], self.c 
olLabels[col])) 


app - wx.PySimpleApp() 
frame - TestFrame() 
frame.Show() 
app.MainLoop() 


正如 添加 和 删除 行 一 样 ， 改 变 标签 也 是 根据 网 格 的 类 型 而 不 同 的 。 对 于 使 

用 CreateGrid() 创建 的 网 格 ， 要 使 

用 SetColLabelValue(col, value) 和 SetRowLabelValue(row, value) 方法 
来 设置 标签 值 ， 如 #1 所 示 。 参 数 col 和 row 是 列 和 行 的 索引 ， value 是 要 显示 
在 标签 中 的 字符 串 。 要 得 到 一 行 或 一 列 的 标签 ， 使 

用 GetColLabelValue(col) 和 GetRowLabelValue(row) 方法 。 


对 于 使 用 外 部 网 格 表 的 一 个 网 格 控件 ， 你 可 以 通过 履 盖 网 格 表 

的 GetColLabelValue(col) 和 GetRowLabelValue(row) 方法 来 达到 相同 的 作 
用 。 为 了 消除 混淆 ， 网 格 控 件 在 当 它 需要 显示 标签 并 且 网 格 有 一 个 关联 的 表 时 ， 内 
在 地 调用 这 些 方 法 。 由 于 返回 值 是 动态 地 由 你 在 覆盖 的 方法 中 所 写 的 代码 决定 的 ， 
所 以 这 里 不 需要 履 盖 或 调用 set 方法 。 不 过 set 方法 仍然 存在 
SetColLabelValue(col, value) 和 SetRowLabelValue(row, value) 一 
一 但 是 你 很 少 会 使 用 到 ， 除 非 你 想 让 用 户 能 够 改变 潜在 的 数据 。 通 常 ， 你 不 需 

要 set * 方 法 。 例 14.4 显 示 了 如 何 改 变 网 格 表 中 的 标签 一 一 这 个 例子 产生 与 上 一 例 
相同 的 输出 。 


例 14.4 带 有 自 定 义 标 签 的 使 用 了 网 格 表 的 网 格 





import wx 
import wx.grid 


class TestTable(wx.grid.PyGridTableBase): 
def — init (self): 
wx.grid.PyGridTableBase. init (self) 
self.rowLabels - ["uno", "dos", "tres", "quatro", "cinco 


self.colLabels = ["homer", "marge", "bart", "lisa", "maggie" ] 


def GetNumberRows( self): 
return 5 


def GetNumberCols(self): 
return 5 


def IsEmptyCell(self, row, col): 
return False 


def GetValue(self, row, col): 
return "(%S,%S)" % (self.rowLabels[row], self.colLabels[ 
col]) 


def SetValue(self, row, col, value): 
pass 


def GetColLabelValue(self, col ):# 列 标签 
return self.colLabels[col] 


def GetRowLabelValue(self, row):# 行 标签 
return self.rowLabels[row] 


class TestFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init__(self, None, title="Grid Table", 
size=(500, 200) ) 
grid = wx.grid.Grid(self) 
table = TestTable() 
grid.SetTable(table, True) 


app = wx.PySimpleApp( ) 
frame = TestFrame() 
frame.Show() 
app.MainLoop() 


默认 情况 下 ， 标 签 是 居中 显示 的 。 但 是 你 也 可 以 使 
用 SetColumnLabelAlignment(horiz, vert) 和 SetRowLabelAlignment (horiz 
来 改变 这 个 行为 。 其 中 参数 horiz 用 以 控制 水 平 对 齐 方式 ， 取 值 


有 wx.ALIGN LEFT, wx.ALIGN CENTRE 或 wx.ALIGN RIGHT ° Až vert 用 以 
控制 重 直 对 齐 方式 ， 取 值 
有 wx.ALIGN_TOP，wx.ALIGN_CENTRE， 或 wx.ALIGN BOTTOM ° 


行 和 列 的 标签 区 域 共 享 一 套 颜 色 和 字体 属性 。 你 可 以 使 

用 SetLabelBackgroundColour(colour) , 

SetLabelFont(font), and SetLabelTextColour(colour) 方法 来 处 理 这 些 属 
性 。 参 数 colour 是 wx.Colour 的 一 个 实例 或 wxPython 会 转换 为 颜色 的 东 
西 ， 如 顾 色 的 字符 串 名 。 参 数 font 是 wx.Font 的 一 个 实例 。 与 set 相应 

的 get 方法 有 GetLabelBackgoundColour(), GetLabelFont() ， 

fe GetLabelTextFont() ° 


如 何 管理 网 格 元 素 的 尺寸 ? 


网 格 控件 提供 了 几 个 不 同 的 方法 来 管理 单元 格 、 行 和 列 的 尺寸 。 在 这 一 节 ， 我 们 将 
讨论 这 些 方 法 。 图 14.4 显 示 了 一 些 用 来 改变 一 个 特定 的 单元 格 的 尺寸 的 方法 。 


例 14.5 显 示 了 创建 了 一 个 带 有 可 调节 大 小 的 单元 格 、 行 和 列 的 网 格 。 
图 14.4 
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114.5 可 调整 尺寸 的 单元 格 的 示例 代码 


import wx 
import wx.grid 


class TestFrame(wx.Frame): 


def _init_ (self): 
wx.Frame. init (self, None, title="Grid Sizes", 
size-(600,300)) 

grid - wx.grid.Grid(self) 

grid.CreateGrid(5,5) 

for row in range(5): 

for col in range(5): 
grid.SetCellValue(row, col, "(96s,96s)" % (row, co 


1)) 


grid.SetCellSize(2, 2, 2, 3) 
grid.SetColSize(1, 125) 
grid.SetRowSize(1, 100) 


app - wx.PySimpleApp() 
frame - TestFrame() 
frame.Show() 
app.MainLoop() 


改变 单元 格 的 尺寸 


一 个 作用 于 单元 格 尺寸 的 基本 的 方法 是 使 它 跨 多 行 或 多 列 ， 类 似 

于 HTML 的 rowspan 和 colspan 。 要 达到 这 种 效果 ， 在 wxPython 中 可 以 使 用 
方法 SetcellSize(row, col, num rows, num cols) 。 该 方法 设置 坐 

标 row,col 处 的 单元 格 跨 num rows 行 和 num cols 列 。 在 通常 的 情形 下 ， 每 
个 单元 格 占据 一 行 和 一 列 ， 要 使 用 单元 格 不 止 占据 一 行 或 一 列 ， 你 需要 给 参 

数 num rows, num cols 大 于 1 的 值 。 参 数 num rows, num cols 的 值 小 于 等 于 
0 会 导致 错误 。 如 果 你 的 设置 使 得 一 个 单元 格 的 尺寸 与 另 一 个 早先 声明 为 跨越 的 单 
元 格 的 尺寸 相 重 又 时 ， 早 先 的 这 个 单元 格 的 尺寸 会 重 置 为 占据 一 行 和 一 列 。 你 也 能 
够 使 用 方法 SetCellOverflow(row, col, allow) 方法 来 关闭 单元 格 的 跨越 显 
示 。 只 要 在 该 方法 中 使 用 pass 就 可 以 阻止 单元 格 跨越 了 ， 即 使 已 经 使 用 

J Setcellsize() 方法 来 设置 它 的 尺寸 。 


调整 网 格 的 尺寸 的 一 个 更 加 典型 的 方法 是 基于 一 行 或 一 列 来 处 理 其 像素 尺寸 。 你 可 
以 使 用 SetColSize(col, width) 和 SetRowSize(row, height) 方法 来 改变 一 
列 或 一 行 的 宽度 。 当 然 ， 你 可 以 使 用 GetColSize(col) 或 GetRowSize(row) 来 
确定 一 列 或 一 行 的 当前 尺寸 。 


设置 默认 尺寸 
你 可 以 通过 改变 所 有 的 行 和 列 的 默认 尺寸 来 改变 整个 网 格 的 尺寸 。 方 法 如 下 : 


SetDefaultColSize(width, resizeExistingCols=False) 
SetDefaultRowSize(height, resizeExistingRows=False ) 


其 中 的 第 一 个 参数 是 以 像素 为 单位 的 新 的 默认 尺寸 。 如 果 第 二 个 布尔 参数 的 值 

是 True ， 那 么 当前 存在 的 所 有 行 或 列 立 即 被 调整 到 新 的 默认 尺寸 。 如 果 第 二 个 参 
数 的 值 为 False ， 那 么 这 个 新 的 默认 尺寸 仅 被 应 用 于 新 添加 的 行 或 列 。 通 常 ， 设 
置 新 的 默认 值 是 在 初始 化 的 开头 ， 甚 至 是 在 调 

用 CreateGrid() 或 SetTable() 之 前 。 你 可 以 使 

用 GetDefaultColsize() 和 GetDefaultRowSize() 方法 来 得 到 当前 的 默认 尺 
+o 


设置 默认 尺寸 与 为 单个 行 或 列 设置 尺寸 相 比 ， 有 一 个 性 能 上 的 问题 。 对 于 存储 默认 
值 ， wxPython 只 需要 存储 这 两 个 整数 。 如 果 你 将 单个 行 或 列 设置 到 一 个 非 默认 的 
尺寸 ， wxPython 切换 并 将 每 个 行 或 列 的 尺寸 存储 到 一 个 数组 中 。 如 果 你 的 表 是 非 
常 的 大 的 话 ， 这 将 明显 地 占用 很 多 的 内 存 ， 因 此 这 是 需要 注意 的 。 


有 时 ， 你 想 为 一 行 或 一 列 设置 一 个 最 小 的 尺寸 ， 以 便 不 用 担心 程序 的 某 个 方法 的 调 
用 或 用 户 对 网 格 线 的 拖 动 会 致使 该 行 或 列 变 得 更 小 。 


在 wxPython 中 ， 你 可 以 对 一 个 网 格 的 宽度 设置 最 小 值 或 为 单独 的 行 和 列 分 别 设置 
最 小 尺寸 值 。 要 改变 整个 网 格 的 最 小 尺寸 ， 可 以 使 用 方 

法 SetColMinimalAcceptablewidth(width) 或 SetRowMinimalAcceptableHeic 
。 其 中 的 参数 是 针对 所 有 行 或 列 的 最 小 的 像素 尺寸 。 要 一 行 一 行 的 设置 最 小 尺寸 ， 
使 用 方 

法 SetcolMinimalWidth(col, width) 或 SetRowMinimalHeight(row, height) 
。 其 中 第 一 个 参数 是 要 调整 尺寸 的 项 目的 索引 ， 第 二 个 参数 是 以 像素 为 单位 的 新 的 
尺寸 。 单 个 的 行 的 最 小 尺寸 必须 比 最 小 的 网 格 尺 寸 大 ， 如 果 单 个 的 行 的 最 小 尺寸 被 
设置 了 的 话 。 上 面 的 set 方法 都 有 一 个 相应 的 get FH: 


e GetColMinimalAcceptablewidth() 
GetRowMinimalAcceptableHeight() GetColMinimalWidth(col) * 
GetRowMinimalHeight (row) 


设置 标签 的 尺寸 


网 格 上 的 标签 区 域 有 一 套 单独 的 调整 尺寸 的 函数 。 在 这 种 情况 下 ， 你 是 在 设置 行 标 
签 的 宽度 和 列 标签 的 高 度 ， 意 思 就 是 ， 把 列 标签 作为 一 个 特殊 的 行 ， 把 行 标签 作为 
一 个 特殊 的 列 。 set * 方 法 有 SetRowLabelSize(width) ， 它 设置 行 标 签 的 宽 
度 ， SetColLabelSize(height) ， 它 设置 列 标签 的 高 度 。 你 可 以 使 用 相应 

的 GetRowLabelSize() 和 GetColLabelSize() 方法 来 得 到 这 些 尺寸 。 


通常 ， 你 不 会 关心 单元 格 的 实际 的 像素 尺寸 ， 你 希望 它们 被 自动 调整 到 足够 显示 你 
的 数据 的 大 小 。 在 wxPython 中 ， 你 可 以 通过 使 用 AutoSize() 方法 来 自动 调整 
整个 网 格 的 尺寸 。 该 方法 使 得 所 有 的 行 和 列 的 尺寸 与 它们 中 的 内 容 相 适应 。 你 也 可 
以 对 单个 的 行 或 列 使 

用 AutoSizeColumn(col, setAsMin=True) 和 AutoSizeRow(row, setAsMin=Tr 
来 使 它们 的 尺寸 自动 与 其 中 的 内 容 相 适应 。 如 果 参 数 setAsMin A True ， 那 么 
新 的 自动 的 尺寸 将 作为 该 行 或 列 的 最 小 尺 

寸 。 AutoSizeColumns(setAsMin=True) 和 AutoSizeRows(setAsMin=True) 
自动 调整 所 有 的 列 和 行 的 尺寸 。 


你 也 可 以 让 用 户 通 过 拖 动 标签 单元 格 的 边框 来 调整 行 的 尺寸 。 用 于 实现 这 种 行为 的 
主要 的 方法 如 下 


e EnableDragColSize(enable=True) : 控制 用 户 能 否 通 过 拖 动 边框 来 改变 
签 的 宽度 


e EnableDragRowSize(enable=True) : 控制 用 户 能 否 通过 拖 动 边框 来 改变 标 
签 的 高 度 


e EnableDragGridSize(enable-True) : 控制 用 户 能 否 通过 拖 动 边框 一 次 性 
改变 标签 的 宽度 和 高 度 


下 面 的 方法 是 上 面 方法 的 相应 的 使 拖 动 无 效 的 简便 的 方法 : 
e DisableDragColSize() 
e DisableDragRowSize() 
e DisableDragGridSize() 
下 面 的 一 套 方 法 用 以 判断 能 否 拖 动 : 
e CanDragColSize() 
e CanDragRowSize() 


e CanDragGridSize() 


如 何 管理 哪些 单元 格 处 于 选择 或 可 见 状态 ? 


在 网 格 控件 中 ， 用 户 可 以 选择 一 个 或 多 个 单元 格 。 在 wxPython 中 ， 有 几 个 方法 让 
你 能 够 处 理 多 选 的 情况 。 


在 下 面 的 几 个 情况 中 ， 网 格 控件 中 的 被 选择 的 项 可 以 是 0 个 或 多 个 : 


e 单个 的 处 于 选择 状态 的 单元 格 
e 被 选择 的 行 

e 被 选择 的 行 

° 择 的 由 单元 格 组 成 的 块 


se 上 的 敲 击 ， 或 拖 动 鼠标 来 选择 多 组 单元 

。 要 确定 网 格 中 是 否 有 被 选择 的 单元 格 ， 可 能 使 用 方法 IsSelection() ， 如 果 
2. 该 方法 返回 国宝 。 bcd psc esr col) FARE 
询 任意 一 个 特定 的 单元 格 当 前 是 否 处 于 选择 状态 中 ， 如 果 是 则 返回 True o 


表 14.2 显 示 了 几 个 方法 ， 它 们 得 到 当前 被 选择 的 内 容 并 返 
表 14.2 返回 当前 被 选择 的 单元 格 的 集 的 方法 


返回 包含 一 些 单个 的 处 于 选择 状态 的 
单元 格 的 一 个 Python 列表 。 在 这 个 
列表 中 的 每 个 项 目 都 是 一 个 

( row, col) 元 组 。 


返回 由 通过 敲 击 列 的 标签 而 被 选择 的 
列 的 索引 组 成 的 一 个 Python 列表 。 


返回 由 通过 敲 击 行 的 标签 而 被 选择 的 
列 的 索引 组 成 的 一 个 Python 列表 。 


返回 包含 一 些 被 选择 的 由 单元 格 组 成 
的 块 的 一 个 python 列表 。 其 中 的 每 
个 元 素 都 时 一 个 ( row, col) 元 组 ， 
( row, col) 元 组 是 每 块 的 左上 角 。 


返回 包含 一 些 被 选择 的 由 单元 格 组 成 
的 块 的 一 个 python 列表 。 其 中 的 每 
个 元 素 都 时 一 个 ( row, col) 元 组 ， 
( row, col) 元 组 是 每 块 的 右 下 角 。 


GetSelectedCells() 


GetSelectedCols() 


GetSelectedRows( ) 


GetSelectionBlockTopLeft( ) 


GetSelectionBlockBottomRight( ) 


这 几 也 有 几 个 用 于 设置 或 修改 选择 状态 的 方法 。 第 一 个 是 ClearSelection() ° 
它 清 除 当 有 的 被 选 状态 。 在 该 方法 被 调用 以 后 IsSelection() 返回 False ° 
你 也 可 以 做 一 个 相反 的 动作 ， 就 是 使 用 SelectAll() 选择 所 有 的 单元 格 。 你 也 可 
以 使 用 方 

法 SelectCol(col, addToSelected=False) 和 SelectRow(row, addToSelecte 
来 选择 整 列 或 整 行 。 在 这 两 个 方法 中 ， 第 一 个 参数 是 要 选择 的 行 或 列 的 索引 。 如 果 
参数 addToSelected 为 True ， 所 有 另外 被 选择 的 单元 格 仍然 处 于 被 选 状态 ， 并 
且 该 行 或 列 也 被 增加 到 已 有 的 选择 中 。 如 果 参 数 addToSelected 为 False ， 那 
么 所 有 另外 被 选择 的 单元 格 解除 被 选 状态 ， 而 新 的 行 或 列 代 替 它 们 作为 被 选择 对 

象 。 同 样 地 ， 你 也 可 以 使 用 方 

法 SelectBlock(topRow, leftCol, bottomRow, rightCol, addToSelected-F: 
来 增加 一 个 对 一 块 范围 的 选择 ， 前 面 四 个 参数 是 所 选 的 范围 的 对 

> addToSelected 参数 的 作用 同 前 一 样 。 


你 也 可 以 使 用 IsVisible(row, col, wholeCellVisible=True) 方法 来 得 到 一 

个 特定 的 单元 格 在 当前 的 显示 中 是 否 是 可 见 的 。 如 果 该 单元 格 当 前 显示 在 屏幕 上 了 
《相对 于 处 在 一 个 可 滚动 的 容器 的 不 可 见 部 分 而 言 ) ， 那 么 该 方法 返回 True 。 如 
RAH wholeCellVisible 为 True ， 那 么 单元 格 要 整个 都 是 可 见 的 ， 方 法 才 返 
回 True ， 如 果 参 数 wholeCellVisible 为 False ， 则 单元 格 部 分 可 见 ， 方 法 

就 会 返回 True 。 方 法 MakeCellVisible(row, col) 通过 滚动 确保 了 指定 位 置 

的 单元 格 是 可 见 的 。 


除了 被 选 的 单元 格外 ， 网 格 控件 也 有 一 个 光标 单元 格 ， 它 代表 获得 当前 用 户 焦点 的 
单元 格 。 你 可 以 使 用 GetGridCursorcol() 和 GetGridCursorRow() 方法 来 确定 
光标 的 当前 位 置 ， 这 两 个 方法 返回 整数 的 索引 值 。 你 可 以 使 

用 SetGridcursor(row, col) 方法 来 显 式 地 放置 一 个 光标 。 该 方法 除了 移 到 光标 
外 ， 它 还 隐 式 地 对 新 的 光标 位 置 调 用 了 MakeCellvisible 。 


表 14.3 说 明了 在 网 格 坐标 和 显示 


表 14.3 坐标 转换 方法 


BlockToDeviceRect(topLeft, 


CellToRect(row, 


XToCol(x) 


XToEdgeOfCol(x) 


YToRow( y) 


YToEdgeOfRow( y) 


你 可 以 使 用 上 面 这 


如 何 改变 一 个 网 格 的 单元 格 的 颜色 和 字体 ?3 


正如 其 它 


co 


Lx 
zs 


坐标 之 间作 转换 的 网 格 控件 的 方法 。 


bottomRight ) 


参 
数 topLeft, bottomRight 
单元 格 的 坐标 
(( row, col) 元 组 的 形 
A) 。 返 回 值 是 一 
wx.Rect ， wx.Rect fs 
E AY) BS AB Y PT eL EI 03 4E: 
p o 


返回 一 

个 wx.Rect * wx.Rect £f 
标 是 相对 网 格 坐标 

( row, col) 处 的 单元 格 的 
器 的 坐标 。 


返回 包含 Xx 坐标 (该 坐标 是 栓 
于 容器 的 ) 的 列 的 索引 。 如 
没有 这 样 的 列 4 M] 3x 
回 wx.NOT FOUND ° 


iR 6] A ib TRIE x 2 
的 列 的 整数 索引 。 如 果 没 有 : 
样 的 列 ， 则 返 

EJ wx.NOT FOUND ° 


返回 包含 y 坐 标 〈 该 坐标 是 模 
pi nee nee 
没有 这 样 的 行 ， 则 返 

回 wx.NOT_FOUND 。 


返回 底 边 缘 最 接近 给 定 的 y 耸 
Cede 如 果 没 有 : 
样 的 行 ， 则 返 

回 wx.NOT FOUND 。 


文 些 方法 来 对 网 格 单元 格 上 的 鼠标 殴 击 的 位 置 作 转换 。 


的 控件 一 样 ， 这 儿 也 有 一 些 属 性 方法 ， 你 可 以 用 来 改变 每 个 单元 格 的 显示 


属性 。 图 14.5 是 个 示例 图 片 。 例 14.6 显 示 了 产生 图 14.5 的 代码 。 注 意 其 中 的 针对 特 
定单 元 格 的 网 格 方法 和 wx.grid.GridCellAttr 对 象 的 创建 方法 的 用 法 。 


图 14.5 


“Grid Attributes — i Jo 





Figure 14.5 
A sample usage of the 
grid attribute methods 























1014.6 改变 网 格 的 单元 格 的 颜色 


import wx 
import wx.grid 


class TestFrame(wx.Frame): 


def _ init (self): 
wx.Frame.__init__(self, None, title="Grid Attributes", 
$ize=(600, 300) ) 

grid = wx.grid.Grid(self ) 

grid.CreateGrid(10,6) 

for row in range(10): 

for col in range(6): 
grid.SetCellValue(row, col, "(%s,%s)" % (row, co 


1)) 


grid.SetCellTextColour(i, 1, "red") 

grid.SetCellFont(1,1, wx.Font(10, wx.SWISS, wx.NORMAL, w 
x.BOLD)) 

grid.SetCellBackgroundColour(2, 2, "light blue") 


attr = wx.grid.GridCellAttr() 
attr.SetTextColour("navyblue") 
attr.SetBackgroundColour ("pink") 
attr.SetFont(wx.Font(10, wx.SWISS, wx.NORMAL, wx.BOLD) ) 


grid.SetAttr(4, 0, attr) 
grid.SetAttr(5, 1, attr) 
grid.SetRowAttr(8, attr) 


app = wx.PySimpleApp( ) 
frame = TestFrame() 
frame.Show() 
app.MainLoop() 


我 们 将 通过 讨论 用 于 设置 整个 网 格 默认 值 的 方法 作为 开始 。 你 可 以 使 
用 SetDefaultcellAlignment(horiz, vert) 方法 来 为 网 格 中 所 有 的 单元 格 设置 
默认 的 对 齐 方式 ， 其 中 horiz 的 取 值 


有 wx.LEFT ^ wx.CENTRE ^ wx.RIGHT * vert 的 取 值 

有 wx.TOP, wx.CENTRE, ° wx.BOTTOM 。 你 可 以 使 

用 GetDefaultCellAlignment() 来 得 到 这 个 默认 的 单元 格 对 齐 方式 ， 该 方法 返 
回 一 个 ( horiz, vert) 元 组 。 


背景 和 文本 的 颜色 可 以 使 

用 SetDefaultCellTextColour(colour) 和 SetDefaultCellBackgroundColour 
方法 来 设置 。 同 样 ， colour 参数 可 以 是 一 个 wx.Colour 实例 或 颜色 名 。 相 应 

的 get * 方 法 

是 GetDefaultCellTextColour() 和 GetDefaultCellBackgroundColour() ° 
最 后 ， 你 可 以 使 用 SetDefaultCellFont(font) 和 GetDefaultCellFont() 来 
处 理 默认 的 字体 。 


使 用 下 面 的 方法 ， 你 可 以 设置 单个 单元 格 的 相关 属性 : 


GetCellAlignment(row, col) 
SetCellAlignment(row, col, horiz, vert) 


GetCellBackgroundColour(row, col) 
SetCellBackgroundColour(row, col, colour) 


GetCellFont(row, col) 
SetCellFont(row, col, font) 


GetCellTextColour(row, col) 
SetCellTextColour(row, col, colour) 


也 可 使 

用 SetSelectionBackground(colour) 和 SetSelectionForeground(colour) 
方法 来 使 用 被 选 的 单元 格 有 另外 背景 色 和 前 景色 ， 相 应 的 get “方法 

是 GetSelectionBackground() 和 GetSelectionForeground() ° 

你 也 可 以 使 用 SetMargins(extraWidth, extraHeight) 方法 来 设置 网 格 控件 与 
它 的 容器 的 边 距 。 


在 内 部 ， 类 wx.grid.Grid 使 用 一 个 名 为 wx.grid.Gridcellattr 类 来 管理 每 个 
单元 格 的 属性 。 wx.grid.GridCellAttr 类 对 于 本 节 所 讨论 到 的 属性 ， 也 

有 get 和 set 方法 。 你 可 以 通过 使 用 GetorcreatecellAttr(row, col) 方法 
来 得 到 关于 一 个 特定 的 单元 格 的 attr 对 象 ， 它 是 单元 格 的 属性 对 象 。 一 个 单元 格 
的 属性 对 象 仅 在 该 单元 格 已 定义 了 非 默认 的 属性 时 才 被 创建 。 一 旦 你 有 了 该 单元 格 
的 属性 对 象 ， 你 就 可 以 用 它 来 定义 该 单元 格 的 显示 属性 。 


要 创建 你 自己 的 单元 格 属 性 对 象 ， 这 个 构造 函数 是 wx.grid.GridCellAttr() ° 
你 可 以 设置 某 些 参数 ， 然 后 将 该 对 象 传递 给 方 
法 SetColAttr (attr) 或 SetRowAttr(attr) ， 这 两 个 方法 将 将 这 些 显示 属性 应 
用 到 该 行 或 列 中 的 每 个 单元 格 ， 如 例 14.6 所 示 。 


如 果 你 在 使 用 一 个 网 格 表 ， 你 可 以 覆盖 方法 GetAttr(row, col) 来 返回 特定 单元 
格 的 一 个 wx.grid.GridCellAttr 实例 。 


你 也 可 以 改变 网 格 线 的 颜色 和 显示 。 网 格 线 的 显示 是 由 方 

法 EnableGridLines(enable) 来 控制 的 。 参 数 enable 是 一 个 布 乐 值 。 如 果 
为 True ， 网 格 线 被 显示 ， 如 果 为 False ， 则 不 显示 。 你 可 以 使 用 方 

法 SetGridLineColor(colour) 来 改变 网 格 线 的 颜色 。 


目 定 义 描 绘 器 和 编辑 器 


是 什么 使 得 网 格 控件 是 如 此 的 灵活 和 有 用 呢 ? 它 就 是 显示 或 编辑 一 个 单元 格 的 内 容 
的 机 制 可 以 被 改变 这 一 特性 。 在 后 面 的 几 节 中 ， 我 们 将 给 你 展示 如 何 去 使 用 预定 义 
的 描绘 器 和 编辑 器 ， 以 及 如 何 写 你 自己 的 描绘 器 和 编辑 器 。 


如 何 使 用 一 个 自 定 义 的 单元 格 描绘 器 ? 


默认 情况 下 ， 网 格 将 它 的 数据 以 简单 字符 串 的 形式 显示 ， 然 而 ， 你 也 可 以 以 不 同 的 
格式 显示 你 的 数据 。 你 可 以 想 将 布尔 值 数据 显示 为 一 个 复 选 框 ， 或 以 图 片 格式 显示 
一 个 数字 值 ， 或 将 一 个 数据 的 列表 以 线条 的 方式 显示 。 


在 wxPython 中 ， 每 个 单元 格 都 可 以 有 它 自己 的 描绘 器 ， 这 使 得 它 能 够 以 不 同 的 方 
式 显示 它 的 数据 。 下 面 的 部 分 讨论 几 个 wxPython 中 预定 义 的 描绘 器 ， 以 及 如 何 定 
义 你 自己 的 描绘 器 。 
预定 义 的 描绘 器 ( renderer) 
一 个 网 格 描绘 器 是 类 wx.grid.GridCellRenderer 的 一 个 实 
f|* wx.grid.GridCellRenderer 是 一 个 抽象 的 父 类 。 一 般 ， 你 会 使 用 它 的 子 

。 它 


类 。 表 14.4 说 明了 几 个 你 可 以 用 在 你 的 单元 格 中 的 预定 义 的 描绘 器 。 它 们 都 有 一 个 
构造 函数 和 get, set 方法 。 


表 14.4 预定 义 的 网 格 单元 格 描绘 器 


显示 文本 化 的 数据 ， 在 单元 
格 边界 按 词 按 行 。 

使 用 一 个 复 选 框 来 描绘 布尔 
数据 选中 表 

T True ， 未 选中 表 


示 False 。 
使 单元 格 能 够 显示 一 个 格式 
化 的 日 期 或 时 间 。 
wx.grid.GridCellEnumRenderer 文本 形式 。 
使 用 指定 位 数 和 精度 来 描绘 
浮上 点数。 该 类 的 构造 函数 要 
wx.grid.GridCellFloatRenderer 求 两 个 参数 ( width= -1, 
precision= -1)。 黑 认 的 
对 齐 方式 为 右 对 齐 。 
数字 数据 。 默 认为 右 对 齐 方 


wx.grid.GridCellAutoWrapStringRenderer 





wx.grid.GridCellBoolRenderer 


wx.grid.GridCellDateTimeRenderer 


wx.grid.GridCellNumberRenderer 


wx.grid.GridCellStringRenderer 简单 字符 串 的 形式 。 


要 得 到 一 个 特定 单元 格 的 描绘 器 ， 可 以 使 用 方 

法 GetCellRenderer(row, col) ， 该 方法 返回 指定 坐标 处 的 单元 格 的 描绘 器 实 
例 。 要 为 一 个 单元 格 设置 描绘 器 ， 可 以 使 

: SetCellRenderer(row, col, renderer) 方法 ， 其 中 renderer 参数 是 用 于 
指定 单元 格 的 新 的 描绘 器 。 这 些 方 法 都 简单 地 设置 或 得 村 到 存储 在 相关 单元 格 属性 对 
象 中 的 描绘 器 ， 所 以 如 果 你 愿意 的 话 ， 你 可 以 直接 处 理 GridCellattr 。 你 可 以 

通过 使 GetDefaultRenderer 和 SetDefaultRenderer(renderer) 来 得 到 和 设 
置 用 于 整个 网 格 的 默认 的 描绘 器 。 


你 也 可 以 为 一 行 设置 描绘 器 ， 这 个 的 典型 应 用 是 电子 表格 中 的 某 列 总 是 显示 特定 类 
型 的 数据 。 实 现 的 方法 

是 SetColFormatBool(col), SetColFormatNumber(col) ， 以 

及 SetColFormatFloat(col, width, precision) ° 


创建 一 个 自 定义 的 描绘 器 


要 创建 你 自 定义 的 单元 格 描绘 器 ， 需 要 创建 wx.grid.PyGridcellRenderer 的 一 
AFH © VEAL LG PAIS E> RRB UAE UAE A ETUR X ARE 。 


图 14.6 显 示 了 一 个 自 定义 描绘 器 的 示例 ， 它 随机 地 绘制 单元 格 的 背景 色 。 
图 14.6 
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例 14.7 


#-*- encoding:UTF-8 -*- 
import wx 

import wx.grid 

import random 


class RandomBackgroundRenderer (wx.grid.PyGridCellRenderer ) :# 定 义 
描绘 器 


def _ init (self): 
wx.grid.PyGridCellRenderer. init__(self) 


def Draw(self, grid, attr, dc, rect, row, col, isSelected):# 


text = grid.GetCellValue(row, col) 
hAlign, vAlign = attr.GetAlignment() 
dc.SetFont( attr.GetFont() ) 

if isSelected: 


bg = grid.GetSelectionBackground( ) 
fg = grid.GetSelectionForeground( ) 
else : 
bg = random.choice(["pink", "Sky blue", "cyan", "yel 


low", "plum" ] ) 
fg 


attr.GetTextColour() 


dc.SetTextBackground(bg) 

dc.SetTextForeground(fg) 

dc.SetBrush(wx.Brush(bg, wx.SOLID)) 

dc.SetPen(wx.TRANSPARENT PEN) 
dc.DrawRectangleRect(rect) 

grid.DrawTextRectangle(dc, text, rect, hAlign, vAlign) 


def GetBestSize(self, grid, attr, dc, row, col): 
text - grid.GetCellValue(row, col) 
dc.SetFont(attr.GetFont()) 
w, h = dc.GetTextExtent(text) 
return wx.Size(w, h) 


def Clone(self): 


return RandomBackgroundRenderer( ) 


class TestFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, title="Grid Renderer", 
size=(640, 480) ) 


grid = wx.grid.Grid(self) 
grid.CreateGrid(50,50) 


# Set this custom renderer just for row 4 
attr = wx.grid.GridCellAttr() 
attr.SetRenderer (RandomBackgroundRenderer ( ) ) 
grid.SetRowAttr(4, attr)4VT #547 


for row in range(10): 
for col in range(10): 
grid.SetCellValue(row, col, 
"cell (%d,%d)" 96 (row, col)) 


app - wx.PySimpleApp() 
frame = TestFrame() 
frame .Show( ) 

app .MainLoop( ) 


你 的 描绘 器 类 必须 覆盖 基 类 的 下 面 三 个 方法 。 


Draw() 
GetBestSize() 
Clone() 


这 三 个 方法 中 最 重要 的 

是 Draw(grid, attr, dc, rect, row, col, isSelected) 。 其 中 参 
数 grid 是 包含 相应 单元 格 的 网 格 实例 。 参 数 attr 是 网 格 的 属性 实例 。 如 果 你 
需要 使 用 基本 的 绘制 方法 的 话 ， 参 数 dc 是 用 于 绘制 的 设备 上 下 文 。 参 数 rect 是 
单元 格 的 矩形 区 域 。 参 数 row, col 是 单元 格 的 坐标 ， 如 果 单 元 格 当 前 处 于 被 选 状 
态 的 话 ， 参 数 isSelected 为 True 。 在 你 的 绘制 方法 中 ， 你 可 以 自由 地 做 任何 
你 想 做 的 事情 。 


NS 


方法 GetBestSize(grid, attr, dc, row, col) 返回 一 个 wx.Size 实例 ， 该 
实例 代表 单元 格 的 首先 尺寸 。 方 法 Clone() 返回 一 

个 wx.grid.GridCellRenderer 实例 。 一 旦 描绘 器 被 定义 了 ， 你 就 可 以 像 使 用 预 
定义 的 描绘 器 一 样 使 用 它 。 


如 何 编辑 一 个 单元 格 ? 


wxPython & ASAE TEAR IR AE GAP I o BABA > PEE A 
个 新 的 数据 值 都 将 打开 一 个 默认 的 字符 串 编辑 器 ， 让 你 可 以 输入 不 同 的 字符 串 。 在 
这 一 节 ， 我 们 将 讨论 多 种 修改 此 默认 行为 的 方法 。 


你 可 以 使 用 方法 EnableEditing(enable) 来 开关 整个 网 格 的 可 编辑 性 参 

数 enable 是 一 个 布尔 值 。 如 果 它 是 False ， 那 么 所 有 的 单元 格 都 不 可 编辑 。 如 
果 关 闭 了 网 格 的 可 编辑 性 ， 那 么 你 就 不 能 再 设置 单个 单元 格 的 编辑 状态 了 。 如 果 打 
开 了 网 格 的 可 编辑 性 的 话 ， 单 个 的 单元 格 可 以 被 指定 为 只 读 。 你 可 以 使 用 方 

法 IsEditable() 来 确定 网 格 是 否 可 编辑 。 





你 可 以 使 用 方法 SetReadOnly(row, col, isReadOnly=True) 来 设置 一 个 特定 单 
元 格 的 编辑 状态 。 isReadonly=True 代表 该 单元 格 为 只 读 ， 为 False 代表 单元 
格 可 编辑 。 SetReadonly() 是 类 wx.grid.GridCellAttr 中 的 同名 方法 的 一 个 
简捷 方式 。 换 名 话说 ， 你 可 以 使 

用 GetCellAttr(row, col).SetReadOnly(isReadOnly) 之 类 的 来 将 一 个 单元 格 
设置 为 只 读 。 使 用 单元 格 属性 机 制 的 好 处 就 是 你 可 以 

将 SetReadOnly 与 SetRowAttr() 和 SetcolAttr() 方法 结合 起 来 ， 以 一 次 性 
的 将 整个 行 或 列 设 置 为 可 编辑 的 或 只 读 的 。 


你 也 可 以 使 用 方 

法 EnableCellEditControl(enable-True) 和 DisableCellEditControl() 来 
处 理 网 格 的 可 编辑 性 ， 第 二 个 方法 等 同 

于 EnablecellEditControl(False) 。 Enable 方法 将 在 当前 所 选择 的 单元 格 中 
创建 并 显示 该 单元 格 的 编辑 器 。 disable 方法 则 相反 。 如 果 enable * 方 法 将 工 
作 于 当前 单元 格 ， 那 么 CanEnableCellControl() 返回 true ， 这 就 意味 该 网 格 
是 可 编辑 并 且 单 元 格 没 有 被 指定 为 只 读 。 如 果 当 前 单元 格 的 编辑 器 被 激活 了 ， 则 方 
法 IsCellEditControlEnabled() 返回 true 。 


这 里 还 有 一 些 内 在 的 可 用 的 方法 ， 你 可 以 用 于 对 编辑 进行 更 细致 的 处 理 。 你 可 以 使 
用 方法 showcellEditControl() 来 触发 当前 单元 格 的 编辑 ， 并 且 你 也 可 以 使 用 方 
法 HideCellEditControl() 该 编辑 。 你 可 以 使 用 方 

法 IsCurrentCellReadOnly() 来 确定 当前 单元 格 可 编辑 的 有 效 性 。 你 可 以 使 用 方 
法 SaveEditControlValue() 来 确保 在 编辑 器 中 所 输入 的 新 值 被 存储 。 当 焦点 从 
被 编辑 的 单元 格 上 移 走 时 ， 网 格 控件 隐 式 地 调用 该 方法 ， 当 在 你 的 程序 中 所 做 的 一 
些 事情 可 能 会 导致 值 被 丢失 时 (比如 关闭 网 格 所 处 的 窗口 时 ) ， 隐 式 地 调用 该 方法 
是 一 个 好 的 方式 。 


每 个 单元 格 都 有 它 自 己 特 定 的 编辑 器 对 象 。 你 可 以 使 用 方 

法 GetCellEditor(row, col) 来 得 到 相关 单元 格 的 编辑 器 的 一 个 引用 ， 返 回 值 是 
是 类 wx.grid.GridcellEditor 的 一 个 实例 。 你 可 以 使 用 方 

法 SetcellEditor(row, col, editor) 来 设置 该 编辑 器 ， 其 中 的 editor 参数 
是 一 个 wx.grid.GridCellEditor 。 你 可 以 使 用 方 

法 GetDefaultEditor() 和 SetDefaultEditor(editor) 来 为 整个 网 格 管理 默 

认 的 编辑 器 。 正 如 描绘 器 一 样 ， 编 辑 器 对 象 作为 与 单元 格 、 行 或 列 相关 

的 wx.grid.GridCellAttr 的 一 部 分 被 存储 。 


如 何 使 用 一 个 自 定 义 的 单元 格 编辑 器 ? 


正如 描绘 器 一 样 ， wxPython 提供 了 几 个 不 同类 型 的 标准 编辑 器 ， 也 让 你 可 以 创建 
你 自己 的 编辑 器 。 


预定 义 的 编辑 器 


ji 


所 有 的 wxPython 编辑 器 都 是 类 wx.grid.GridCellEditor 的 子 类 。 表 14.5 说 明 
了 这 些 标准 的 编辑 器 。 


在 接 下 来 的 部 分 ， 我 们 将 给 你 展示 如 何 创 建 
表 14.5 wxPyhton 中 的 单元 格 编辑 器 


WX . 


WX . 


WX. 


WX. 


WX. 


WX. 


grid.GridCellAutowrapStringEditor 


omidi 


grid. 


grid. 


grid. 


grid. 


GridCellBooleanEditor 


GridCellChoiceEditor 


GridCellEnumEditor 


GridCellFloatEditor 


GridCellNumberEditor 


wx.grid.GridCellTextEditor 


建 自 定 义 的 编辑 器 


建 自 定义 的 单元 格 编辑 器 。 


使 用 多 行文 本 控件 来 编辑 数据 值 


用 于 单元 格 布尔 值 的 编辑 器 ， 由 
框 构成 作 ， 双 击 显示 该 复 选 框 ° 
布尔 值 描绘 器 用 于 一 个 布尔 值 编 
你 可 以 用 1 或 0， 或 者 on / off 
东西 来 替代 布尔 值 描绘 器 来 显示 
选 状态 。 


复合 框 编辑 器 。 这 个 构造 函数 要 
数 


继承 
自 wx.grid.GridCellChoiceE 
将 数字 换 成 等 同 的 字符 串 呈 现 给 


用 于 输入 指定 精度 的 浮 点 数 。 这 
数 要 求 的 参数 是 

( width= -1， precision= -1 
的 意义 与 相应 描绘 器 中 的 意思 一 
这 个 编辑 器 输入 的 数 被 转换 到 相 
和 精度 。 


整数 编辑 器 。 该 构造 函数 要 求 的 

( min= -1, max- -1)° # 

果 min 和 max HAT ° BAR 

器 将 进行 范围 检查 ， 并 否决 试图 

pe 单元 格 的 右边 会 有 一 
个 spinner 控件 ， 使 用 户 可 以 

xo 单元 格 中 的 值 。 


默认 的 文本 编辑 器 


你 可 以 想 创建 一 个 自 定义 的 编辑 器 自 行 处 理 输入 的 数据 。 要 创 建 你 自己 m 
你 要 创建 wx.grid.PyGridCellEditor 的 一 个 子 类 。 这 比 描绘 器 复杂 些 。 表 146 


显示 了 几 个 你 需要 覆盖 的 方法 。 


表 14.7 显 示 了 父 类 的 更 多 的 方法 ， 你 可 以 覆盖 它们 以 改进 你 的 自 定义 编辑 器 的 外 
Xo 


14.6 你 必须 覆盖 的 PyGridCellEditor 的 方法 


参数 row, col EF 
fe? grid 是 包含 的 单元 格 。 该 方法 


BeginEdit(row, col, grid) 在 编辑 请 求 之 初 被 调用 。 在 该 方法 
中 ， 编 辑 器 用 于 得 到 数据 去 编辑 ， 并 
为 编辑 做 准 工作 。 

Clone() 返回 该 编辑 器 的 一 个 拷贝 。 


创建 被 编辑 器 使 用 的 控件 。 

数 parent 是 容器 ， id rene 
的 控件 的 标识 符 ， evtHandler X 
绑 定 到 该 新 控件 的 事件 处 理 器 。 


如 果 编 辑 已 经 改变 了 单元 格 的 值 ， 则 
EndEdit(row, col, grid) 返回 True 。 任 何其 它 的 必须 的 清除 

工作 都 应 该 在 这 里 被 执行 。 

S 了 ， 则 该 方法 被 调 
Reset() 。 此 时 应 该 将 控件 中 的 值 还 原 为 初 

Lu o 


Create(parent, id, evtHandler) 


R147 TAR SHY PycridcellEditor 的 方法 


当 编 辑 被 销毁 时 ， 执 行 任 何 最 终 的 清除 
工作 。 


如 果 evt 中 的 键 被 按 下 会 启动 编辑 器 ， 

则 方法 返回 True 。 F2 键 始终 都 用 于 
IsAcceptedKey(evt) 启动 编辑 器 。 蕨 类 假设 任意 键 的 按 下 都 

将 启动 编辑 器 ， 除 非 它 被 修改 为 通 

过 control,alt， 或 shift 来 启动 。 


参数 rect 是 一 个 wx.Rect (使 用 加 
辑 单 位 ) > attr 是 与 单元 格 相 关 

的 wc.grid.GridCellattr ° 该 方法 的 
目的 是 绘制 没有 被 编辑 器 控件 所 履 盖 的 
单元 格 的 部 分 。 基 类 通过 属性 得 导 到 背景 
色 并 使 用 得 到 的 背景 色 填 充 矩 形 。 


rect X — 4 AE HE E EAR E938 AER 
SetSize(rect) 度 的 wx.Rect 。 如 果 必 要 的 话 ， 可 以 使 
用 该 方法 来 将 控件 定位 在 该 矩形 内 。 


参数 show 是 一 个 布尔 值 ， 它 决定 是 否 
显示 编辑 器 ， attr 是 相关 单元 格 的 属 
性 实例 。 调 用 该 方法 来 显示 或 隐藏 编辑 


o 


当 编 辑 过 在 单元 格 上 的 一 个 鼠标 敲 
Mc RE 
RA Aak A T A hg Hkg o 


beu IDE iq n 
> 那么 该 方法 被 调用 来 允许 编辑 器 控 


Destroy() 


PaintBackground(rect, attr) 


Show(show, attr) 


ag 


Br 


StartingClick() 


StartingKey(evt) 件 使 用 该 按键， ， 如 果 你 想 的 话 。 (d 
如 ， 通 过 使 用 它 作 为 实际 编辑 器 的 一 部 
分 ) 。 


一 旦 你 的 编辑 器 完成 了 ， 你 就 可 以 使 用 SetCelleditor 方法 将 它 设置 为 任何 单元 
格 的 编辑 器 。 例 1 地 过 定义 编辑 器 的 示例 ， 这 个 例子 自动 将 你 输入 的 文 
本 转换 为 大 号 。 


例 14.8 创建 自 定 义 的 大 写 编辑 器 


#-*- encoding:UTF-8 -*- 
import wx 

import wx.grid 

import string 


class UpCaseCellEditor(wx.grid.PyGridCellEditor) :# 声 明 编辑 器 
def _ init (self): 
wx.grid.PyGridCellEditor. init__(self) 


def Create(self, parent, id, evtHandler ):# 创 建 


Called to create the control, which must derive from wx.Control 


*Must Override* 
self. tc = wx.TextCtrl(parent, id, "") 
self. tc.SetInsertionPoint(0) 
self.SetControl(self. tc) 


if evtHandler: 
self. tc.PushEventHandler(evtHandler) 


self. tc.Bind(wx.EVT CHAR, self.OnChar) 


def SetSize(self, rect): 
Called to position/size the edit control within the cell rectan 
gle. 
If you don't fill the cell (the rect) then be sure to override 
PaintBackground and do something meaningful there. 
self. tc.SetDimensions(rect.x, rect.y, rect.width+2, rec 
t.height+2, 
WX.SIZE ALLOW MINUS ONE) 


def BeginEdit(self, row, col, grid): 
Fetch the value from the table and prepare the edit control 
to begin editing. Set the focus to the edit control. 
*Must Override* 
self.startValue - grid.GetTable().GetValue(row, col) 
self. tc.SetValue(self.startValue) 
self. tc.SetInsertionPointEnd() 
self. tc.SetFocus() 
self. tc.SetSelection(0, self. tc.GetLastPosition()) 


def EndEdit(self, row, col, grid): 
Complete the editing of the current cell. Returns True if the v 
alue 
has changed. If necessary, the control may be destroyed. 
*Must Override* 


changed - False 
val - self. tc.GetValue() 
if val !- self.startValue: 


changed - True 
grid.GetTable().SetValue(row, col, val) # update the 


table 


self.startValue = '' 
self._tc.SetValue('') 
return changed 


def Reset(self): 
Reset the value in the control back to its starting value. 
*Must Override* 
self._tc.SetValue(self.startValue) 
self. tc.SetInsertionPointEnd() 


def Clone(self): 
Create a new object which is the copy of this one 
*Must Override* 


return UpCaseCellEditor() 


def StartingKey(self, evt): 

If the editor is enabled by pressing keys on the grid, this wil 
l be 
called to let the editor do something about that first key if d 
esired. 

self.Onchar(evt) 

if evt.GetSkipped(): 

self. tc.EmulateKeyPress(evt) 


def OnChar(self, evt): 

key = evt.GetKeyCode() 

if key 255: 
evt.Skip() 
return 

char = chr(key) 

if char in string.letters: 
char - char.upper() 
self. tc.WriteText(char)2464&7j X 5 

else: 
evt.Skip() 


class TestFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init (self, None, title="Grid Editor", 
size=(640, 480) ) 


grid = wx.grid.Grid(self ) 
grid.CreateGrid(50, 50) 
grid.SetDefaultEditor (UpCaseCellEditor())#1% E 9X £i ft S 


app = wx.PySimpleApp( ) 
frame = TestFrame() 
frame.Show( ) 

app .MainLoop( ) 


捕获 用 户 事件 

网 格 控件 有 许多 的 用 户 事件 。 我 们 将 把 它们 分 为 鼠标 事件 和 键盘 事件 。 
如 何 捕获 用 户 的 鼠标 动作 ? 

对 于 网 格 控件 ， 除 了 不 同 的 鼠标 事件 类 型 外 ， 对 于 这 些 类 型 还 有 一 些 不 同 的 事件 
类 。 最 常用 的 事件 类 是 wx.grid.GridEvent 。 网 格 的 事件 类 


是 wx.CommandEvent 的 一 个 子 类 ， 它 提供 了 用 于 获得 事件 详情 的 几 个 方法 ， 如 表 
14.8 所 示 。 


表 14.8 wx.grid.GridEvent 的 方法 


当 事 件 被 触发 时 ， 如 果 alt 键 被 按 下 了 ， 则 返 


AltDown() EIUS 
u Oo 

COREAGUDSRHO d diui > 如 果 control 键 被 按 下 了 ， 则 返 
u Oo 

GetCol() 返回 发 生 事件 的 单元 格 所 在 的 列 的 索引 。 


返回 返回 一 个 wx.Point 。 它 代表 事件 发 生 点 的 逻辑 坐标 
(以 像素 为 单位 ) o 

GetRow() 返回 发 生 事件 的 单元 格 所 在 的 行 的 索引 。 

当 事 件 被 触发 时 ， 如 果 met HAIR TT > MA 

回 True ° 

如 果 事 件 是 一 个 被 选 事件 ， 则 返回 True ， 如 果 事 件 是 取 
消 选择 事件 ， 则 返回 False 。 

当 事 件 被 触发 时 ， 如 果 shift MRIS T > Ww 

EJ True ° 


GetPosition( ) 


MetaDown( ) 
Selecting() 
Shif tDown() 


与 wx.grid.GridEvent 相关 的 有 几 个 不 同 的 事件 类 型 。 如 表 14.9 所 示 。 
表 14.9 关于 网 格 和 鼠标 事件 的 单元 格 事件 类 型 


当 用 户 通过 编辑 器 改变 单元 格 
中 的 数据 时 触发 该 事件 。 

当 用 户 在 一 个 单元 格 中 融 击 鼠 
标 左 键 时 触发 该 事件 。 

当 用 户 在 一 个 单元 格 中 双击 鼠 
标 左 键 时 触发 该 事件 。 

SA PEPE ZG T ah R 
标 右 键 时 触发 该 事件 。 

SAP EAP OER 
标 右 键 时 触发 该 事件 。 


当 在 编辑 会 话 结束 时 隐藏 一 个 
.EVT GRID EDITOR HIDDEN 
MX CLOS Eee - 单元 格 编辑 器 则 触发 该 事件 。 


当 在 编辑 会 话 结束 时 显示 一 个 

RRBARRARAATE. 

4 A P APRS Uds AL 
击 和 鼠标 左 键 时 触发 该 事件 。 


当 用 户 在 行 或 列 的 标签 区 域 双 
击 筷 标 左 键 时 触发 该 事件 。 


当 用 户 在 行 或 列 的 标签 区 域 敲 
击 鼠 标 右键 时 触发 该 事件 。 


当 用 户 在 行 或 列 的 标签 区 域 双 
击 鼠 标 右键 时 触发 该 事件 。 


当 es 点 移 到 一 个 新 的 单 
wx.grid.EVT GRID Select CELL 元 格 ， 并 选择 它 时 触发 该 事 
件 。 


wx.grid.EVT_GRID_CELL_CHANGE 





WX geb enya call OEIISISE ES Ine PECES 








wx.grid.EVT_GRID_ CELL_LEFT_DCLICK 


wx.grid.EVT_GRID_CELL_ RIGHT_CLICK 





wx.grid.EVT_GRID_CELL_ RIGHT_DCLICK 





wx.grid.EVT_GRID_EDITOR_SHOWN 
wx.grid.EVT_GRID_LABEL_LEFT_CLICK 
wx.grid.EVT_GRID_LABEL_LEFT_DCLICK 
wx.grid.EVT_GRID_LABEL_RIGHT_CLICK 


wx.grid.EVT_GRID_LABEL_RIGHT_DCLICK 


有 两 个 事件 类 型 ， 它 们 有 一 个 wx.grid.GridSizeEvent 实例 。 这 两 个 事件 类 型 分 
别 是 wx.grid.EVT GRID COL SIZE : 当 列 大 小 被 改变 时 触 

发 ，wx.grid.EVT_GRID_ROW_SIZE : 当 行 的 大 小 被 改变 时 触发 。 网 格 的 尺寸 事 
件 有 5 个 

与 wx.GridEvent ! AltDown(), ControlDown(), GetPosition(), MetaDow(), 
fe ShiftDown 相同 的 方法 。 wx.grid.GridSizeEvent 的 最 后 的 一 个 方法 

是 GetRowOrCol() ， 该 方法 返回 发 生 改 变 的 列 或 行 的 索引 ， 当 然 这 依赖 于 具体 的 
事件 类 型 。 


事件 类 型 wx.grid.EVT GRID RANGE Select 有 一 

个 wx.grid.GridRangeSelectEvent 的 实例 ， 该 事件 当 用 户 选择 连续 矩形 范围 内 
的 单元 格 中 被 触发 。 该 事件 的 实例 拥有 的 方法 

是 GetBottomRightCoords(), GetBottomRow(), GetLeftCol(), GetRightCol\ 
fe GetTopRow() ， 它 们 返回 被 选择 区 域 的 整数 索引 或 ( row, col) 元 组 。 


最 后 ， 事 件 类 型 EVT GRID EDITOR CreateD 有 一 

个 wx.grid.GridEditorCreatedEvent 实例 。 这 个 事件 在 当 通 过 一 个 编辑 会 话 创 
建 了 一 个 编辑 器 时 被 触发 。 该 事件 实例 的 方法 

有 GetCol(), GetRow(), fe GetControl() ， 它 们 分 别 返 回 发 生 事件 的 列 ， 行 
的 索引 和 使 用 的 编辑 控件 。 


如 何 捕获 用 户 的 键盘 动作 ? 


除了 使 用 鼠标 外 ， 用 户 还 可 以 使 用 键盘 来 在 网 格 中 移动 。 你 可 以 通过 代码 的 方法 来 
使 用 表 14.10 中 的 移动 方法 改变 光标 。 其 中 的 许多 方法 都 要 求 一 

个 expandSelection 参数 。 每 个 方法 中 的 expandSelection 的 作用 都 相同 。 如 
果 这 个 参数 为 True ， 那 么 当前 的 选项 将 被 扩展 以 容纳 这 个 新 的 光标 位 置 。 如 果 这 
个 参数 为 False ， 那 么 当前 的 选项 被 新 的 光标 所 取代 。 


表 14.10 网 格 光 标 移动 方法 


向 下 移动 光标 。 如 

果 expandSelection 7 Fal: 
MoveCursorDown(expandSelection) 等 同 于 按 下 "下 箭头 键 "， 如 果 

为 True ， 则 等 同 于 按 下 " sh: 


向 下 移动 光标 。 如 

果 expandSelection 7 Fal: 
MoveCursorDownBlock(expandSelection) 则 等 同 于 " ctrl -下 箭头 键 "， 

为 True ， 则 等 同 

T" shift - ctrl -F a 3 4" 


向 堪 移 动 光标 。 如 

果 expandSelection 7 Fal: 
MoveCursorLeft(expandSelection) Se] de F "4 at ES dX 

A True ， 则 等 同 于 按 下 " sh: 


向 堪 移 动 光标 。 如 

果 expandSelection 7 Fal: 
MoveCursorLeftBlock(expandSelection) 则 等 同 于 " ctrl - 左 箭头 键 "， 

A True ， 则 等 同 

es 


向 右 移 动 光标 。 如 

果 expandSelection 7 Fal: 
MoveCursorRight(expandSelection) 等 同 于 按 下 " 右 箭 头 键 "， 如 果 

为 True ， 则 等 同 于 按 下 " sh: 


向 右 移动 光 标 。 如 
果 expandSelection A Fal: 


MoveCursorRightBlock(expandSelection) 则 等 同 于 " ctrl - 右 箭 头 键 "， 
为 True ， 则 等 同 
T" shift - ctrl - 右 箭头 键 " 


向 上 移动 光标 。 如 

果 expandSelection 7 Fal: 
MoveCursorUp(expandSelection) 等 同 于 按 下 "上 箭头 键 "， 如 果 

为 True ， 则 等 同 于 按 下 " sh: 


向 上 移动 光标 。 如 

果 expandSelection 7 Fal: 
MoveCursorUpBlock(expandSelection) 则 等 同 于 " ctrl -上 箭头 键 "， 

为 True ， 则 等 同 

T" shift - ctrl - Esp x 4E" 


MovePageDown( ) 显示 下 一 页 的 单元 格 。 
MovePageUp() 显示 上 一 页 的 单元 格 。 


我 们 已 经 涵盖 了 所 有 你 需要 了 解 的 有 关 单 元 格 的 知识 。 在 下 一 章 中 ， 我 们 将 讨论 树 
形 控件 。 


本 草 小 结 


1、 网 格 控件 使 你 能 够 创建 像 电 子 表格 一 样 的 网 格 表 ， 并 具有 很 大 的 可 控 性 和 灵活 
性 。 网 格 控件 是 类 wx.grid.Grid 的 一 个 实例 。 通 常 ， 如 果 使 用 网 网 格 控件 处 理 复 
杂 的 问题 的 话 ， 你 应 该 通过 init 方法 来 定义 它 的 子 类 ， 这 是 值得 的 ， 而 非 仅 
仅 创 建 基 类 的 一 个 实例 并 在 程序 的 其 它 地 方 调用 它 的 方法 。 


2、 有 两 种 方法 用 来 将 数据 放 入 一 个 网 格 控件 中 。 rs 

用 CreateGrid(numRows, numCols) 方法 被 显 式 创建 ， 然 后 使 

用 SetCellvalue(row, col, s) 方法 来 设置 单个 的 单元 格 。 另 一 种 是 ， 你 可 以 
创建 一 个 网 格 表 的 实例 ， 该 网 格 表 作 为 网 格 的 一 个 模型 ， 它 使 你 可 以 很 容易 地 使 用 
另 一 数据 源 的 数据 并 显示 在 网 格 中 。 网 格 表 是 wx.grid.PyGridTableBase 的 子 
类 ，wx.grid.PyGridTableBase 的 方法 中 ， GetValue(row, col) 可 以 被 覆盖 
以 在 显示 一 个 单元 格 时 驱动 网 格 的 行为 。 网 格 表 被 连接 到 网 格 控件 使 用 方 

法 SetTable(table) 。 当 使 用 网 格 表 的 方法 创建 了 网 格 后 ， 可 以 通过 网 格 表 的 方 
法 来 改变 网 格 的 行 和 列 数 。 


3、 网 格 也 有 行 和 列 标签 ， 标 签 有 默认 的 值 ， 类 似 于 电子 表格 。 标 签 所 显示 的 文本 
和 标签 的 其 它 显示 属性 可 以 使 用 网 格 的 方法 来 改变 。 每 个 项 的 行 和 列 的 尺寸 可 以 被 
显 式 了 设置 ， 或 者 网 格 可 以 根据 所 显示 的 自 动 调整 尺寸 。 用 户 也 可 通过 拖 动 网 格 线 
来 改变 网 格 的 尺寸 。 如 果 需 要 的 话 ， 你 可 以 为 每 行 或 每 列 设置 一 个 最 小 的 尺寸 ， 以 
防止 单元 格 变 得 太 小 而 不 能 显示 相应 的 数据 。 另 外 ， 特 定 的 单元 格 了 能 使 

用 setcellsize(row, col, numrows, numcols) 方法 来 达到 跨行 或 列 的 目的 。 


4、 用 户 可 以 选择 网 格 中 的 一 个 或 多 个 矩形 范围 的 网 格 ， 这 也 可 以 通过 使 用 很 多 不 
同 的 select * 方 法 以 程序 化 的 方式 实现 相同 的 效果 。 一 个 没有 在 显示 区 域 中 的 网 
格 单元 ， 可 能 使 用 MakeCellVisible(row, col) 方法 来 将 它 移 到 显示 区 域 上 。 


5、 建 自 定义 的 描绘 器 和 编 
辑 器 这 一 能 力 。 描 绘 器 用 于 控件 单元 格 中 的 信息 显示 。 默 认 的 描绘 器 只 是 一 个 简单 
的 字符 串 ， 但 是 还 有 用 于 布尔 值 、 整 数 和 浮 点 数 的 预先 定义 好 (预定 义 ) 的 描绘 

器 。 你 可 以 通过 子 类 化 wx.Grid.PyGridCellRenderer 创建 你 自己 的 描绘 器 并 履 
盖 它 的 绘制 方法 。 


、 默 认 情 况 下 ， 网 格 允 许 就 地 编辑 数据 。 你 dock eue (针对 单元 格 ， 或 
行 或 列 ， 或 整个 网 格 ) 。 当 编辑 时 ， 编 辑 器 对 象 控制 给 用 户 的 东西 。 默 认 的 编 
辑 器 是 一 个 用 以 修改 字符 串 的 普通 的 文本 编辑 器 控件 o 。 其 它 还 有 用 于 布尔 值 、 整 数 
辑 器 。 你 可 以 通过 子 类 化 wx,.grid.Gridcel1Editor ## 

它 的 几 个 方法 来 创建 自 己 的 自 定 义 的 编辑 器 。 


7、 网 格 控件 有 许多 你 能 捕获 的 不 同 的 事件 ， 分 别 包 括 单元 格 中 的 鼠标 散 击 和 标签 
中 的 鼠标 裔 击 事 件 ， 以 及 通过 改变 一 个 单元 格 的 尺寸 而 触发 的 事件 。 另 外 ， 你 能 够 
以 编程 的 方式 在 网 格 中 移动 光标 。 


全 


第 十 五 章 树 形 控件 


本 划 内 容 


e 创建 树 形 控件 并 添加 项 目 
o 使 用 样式 来 设计 树 形 控件 
o 在 程序 中 访问 树 形 控件 

e 处 理 树 形 控件 中 的 选择 

e 控制 项 目的 可 见 性 


树 形 控 件 是 用 于 显示 复杂 数据 的 控件 。 这 里 ， 树 形 控件 被 设计 用 来 通过 分 级 层 来 显 
示 数 据 ， 你 可 以 看 到 每 块 数据 都 有 父子 方面 的 东西 。 一 个 标准 的 例子 就 是 文件 树 ， 
其 中 的 目录 中 有 子 目 录 或 文件 ， 从 而 形成 了 文 件 的 一 个 虞 套 的 层次 。 另 一 个 例子 
是 HTML 或 XML 文档 的 文档 对 象 模型 ( DOM) 树 。 和 列表 与 网 格 控件 一 样 ， 树 形 
控件 也 提供 了 在 项 目 显示 方面 的 灵活 性 ， 并 人 允许 你 就 地 编辑 树 形 控件 中 的 项 目 。 在 
这 一 章 中 ， 我 们 将 给 你 展示 如 何 编辑 树 形 控件 中 的 项 目 及 如 何 响应 用 户 事件 。 


创建 树 形 控件 并 添加 项 目 


树 形 控件 是 类 wx.Treectrl 的 实例 。 图 15.1 显 示 了 一 个 树 形 控 件 的 样 例 。 


图 15.1 
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Figure 15.1 A basic tree control example 


例 15.1 是 产生 图 15.1 的 代码 。 这 个 例子 中 的 机 制 我 们 将 在 后 面 的 部 分 讨论 。 注 意 其 
中 的 树 形 控件 中 的 数据 是 来 自 于 一 个 名 为 data.py 外 部 文件 的 。 


例 15.1 树 形 控件 示例 


import wx 
import data 
class TestFrame(wx.Frame): 
def _init_ (self): 

wx.Frame. init (self, None, title="Simple tree", size- 
(400, 500)) 

# Create the tree 

self.tree = wx.TreeCtrl(self) 

# Add a root node 

root = self.tree.AddRoot("wx.Object") 

# Add nodes from our data set 

self.AddTreeNodes(root, data.tree) 

# Bind some interesting events 

self.Bind(wx.EVT TREE ITEM EXPANDED, self .OnItemExpanded 
, self.tree) 

self.Bind(wx.EVT TREE ITEM COLLAPSED, self.OnItemCollaps 
ed, self.tree) 

self.Bind(wx.EVT TREE SEL CHANGED, self.OnSelChanged, se 
lf.tree) 

self.Bind(wx.EVT TREE ITEM ACTIVATED, self.OnActivated, 
self.tree) 

# Expand the first level 

self.tree.Expand(root) 

def AddTreeNodes(self, parentItem, items): 











Recursively traverses the data structure, adding tree nodes to 
match it. 
for item in items: 
if type(item) -- str: 
self.tree.AppendItem(parentItem, item) 
else: 
newItem = self.tree.AppendItem(parentItem, item[ 


9] ) 
self .AddTreeNodes(newItem, item[1]) 


def GetItemText(self, item): 
if item: 
return self.tree.GetItemText (item) 
else: 
return 7" 


def OnItemExpanded(self, evt): 
print "OnItemExpanded: ", self.GetItemText(evt.GetItem() 


def OnItemCollapsed(self, evt): 
print "OnItemCollapsed:", self.GetItemText(evt.GetItem() 


def OnSelChanged(self, evt): 
print "OnSelChanged: ", self.GetItemText(evt.GetItem() ) 
def OnActivated(self, evt): 


print "OnActivated: ", self.GetItemText(evt.GetItem()) 
app = wx.PySimpleApp(redirect-True) 
frame = TestFrame() 
frame.Show() 
app.MainLoop() 


下 面 的 wx.Treectrl 的 构造 函数 是 一 个 典型 的 wxPython 窗口 部 件 构造 函数 : 


wx.TreeControl(parent, id=-1, pos=wx.DefaultPosition, 
size-wx.DefaultSize, style-wx.TR HAS BUTTONS, 
validator=wx.DefaultValidator, name="treeCtrl") 


其 中 的 参数 意义 与 通常 的 wx.window 对 象 相 同 。 该 构造 函数 提供 给 你 了 一 个 没有 
元 素 的 空 的 树 。 


AY data.py 文件 : 


# Some sample data for the treectrl samples 
tree = [ 
"wx.AcceleratorTable", 
wx.BrushList", 
wx.BusyInfo", 
"wx.Clipboard", 
wx.Colour", 
"wx.ColourData", 
"wx.ColourDatabase", 
"wx.ContextHelp", 
[ "wx. Dc", [ 

"wx.ClientDC", 

["wx.MemoryDC", [ 
"wx.lib.colourchooser.canvas.BitmapBuffer", 
["wx.BufferedDC", [ 

"wx.BufferedPaintDC", ]]]], 

"wx.MetaFileDC", 

"wx.MirrorDC", 

"wx.PaintDC", 

"wx.PostScriptDC", 

"wx.PrinterDC", 

"wx.ScreenDC", 

"wx.WindowDC",]], 

"wx.DragImage", 
"wx.Effects", 
"wx.EncodingConverter", 
["wx.Event", [ 

"wx.ActivateEvent", 

"wx.CalculateLayoutEvent", 

"wx.CloseEvent", 

["wx.CommandEvent", [ 
"wx.calendar.CalendarEvent", 
"wx.ChildFocusEvent", 


"wx.ContextMenuEvent", 
"wx.gizmos.DynamicSashSplitEvent", 
"wx.gizmos.DynamicSashUnifyEvent", 
wx.FindDialogEvent", 
"wx.grid.GridEditorCreatedEvent", 
"wx.HelpEvent", 
["wx.NotifyEvent",[ 

["wx.BookCtrlEvent", [ 
"wx.ListbookEvent", 
"wx.NotebookEvent ",]], 

"wx.grid.GridEvent", 

"wx.grid.GridRangeSelectEvent", 

"wx.grid.GridSizeEvent", 

"wx.ListEvent", 

"wx.SpinEvent", 

wx.SplitterEvent", 
"wx.TreeEvent", 
"wx.wizard.WizardEvent ",]], 

["wx.PyCommandEvent", [ 

"wx.lib.colourselect.ColourSelectEvent", 

"wx.lib.buttons.GenButtonEvent", 

"wx.lib.gridmovers.GridColMoveEvent", 

"wx.lib.gridmovers.GridRowMoveEvent", 

"wx.lib.intctrl.IntUpdatedEvent", 

wx.lib.masked.combobox.MaskedComboBoxSele 
ctEvent", 
wx.lib.masked.numctrl.NumberUpdatedEvent" 


"wx.lib.masked.timectrl.TimeUpdatedEvent " 
; ll; 

"wx.SashEvent", 
wx.ScrollEvent", 
wx.stc.StyledTextEvent", 

"wx.TextUrlEvent", 
"wx.UpdateUIEvent", 
"wx.WindowCreateEvent", 
"wx.WindowDestroyEvent ",]], 
"wx .DisplayChangedEvent", 
"wx.DropFilesEvent", 
"wx.EraseEvent", 
wx.FocusEvent", 
wx.IconizeEvent", 
"wx.IdleEvent", 
"wx.InitDialogEvent", 
wx. JoystickEvent", 
wx.KeyEvent", 
wx .MaximizeEvent", 
wx .MenuEvent", 
wx .MouseCaptureChangedEvent", 
wx .MouseEvent", 
wx.MoveEvent", 
"wx .NavigationKeyEvent", 
wx.NcPaintEvent", 


"wx.PaintEvent", 

"wx .PaletteChangedEvent", 

"wx.ProcessEvent", 

["wx.PyEvent", [ 
"wx.lib.throbber.UpdateThrobberEvent ",]], 

"wx.QueryLayoutInfoEvent", 

"wx.QueryNewPaletteEvent", 

"wx.ScrollWinEvent", 

"wx.SetCursorEvent", 

"wx.ShowEvent", 

wx.SizeEvent", 
"wx .SysColourChangedEvent", 
"wx.TaskBarIconEvent", 
"wx.TimerEvent ",]], 

["wx.EvtHandler", [ 
"wx.lib.gridmovers.GridColMover", 
"wx.lib.gridmovers.GridRowMover", 
"wx.html.HtmlHelpController", 

wx.Menu", 

wx.Process", 


["wx.PyApp", [ 


wx.py.PyAlaCarte.App", 
"wx.py.PyAlaMode.App", 
"wx.py.PyAlaModeTest.App", 
wx.py.PyCrust.App", 
"wx.py.PyShell.App", 
["wx.py.filling.App", [ 
"wx. py.PyFilling.App ",]], 
["wx.PySimpleApp", [ 
"wx.lib.masked.maskededit.test",]], 
"wx.PyWidgetTester ",]]]], 


"wx.TaskBarIcon", 
["wx.Timer", [ 
"wx.PyTimer ",]], 
["wx.Validator", [ 
["wx.PyValidator",[ 
"wx.lib.intctrl.IntValidator",]]]l, 
["wx.Window", [ 
["wx.lib.colourchooser.canvas.Canvas", [ 
"wx.lib.colourchooser.pycolourslider.PyCol 
ourSlider", 
"wx.lib.colourchooser.pypalette.PyPalette" 
ri, 
"wx.lib.gridmovers.ColDragwindow", 
["wx.Control",[ 
["wx.BookCtrl", [ 
"wx.Listbook", 
[ "wx .Notebook", [ 
"wx. py.editor.EditorNotebook", 
"wx. py.editor.EditorShellNoteb 


ook", ]] 1], 


ect", 


,]] 1], 


omboBox", [ 


ox", 


kedComboBox",]] J], 


on", [ 


apTextButton", [ 


["wx.Button", [ 
["wx.BitmapButton", [ 
"wx.lib.colourselect.ColourSel 


"wx.ContextHelpButton", 
"wx.lib.foldmenu.FoldOutMenu " 


"wx.calendar.CalendarCtrl", 

"wx .CheckBox", 

["wx.ComboBox" , [ 
["wx.lib.masked.combobox.BaseMaskedC 


"wx.lib.masked.combobox.ComboB 
"wx.lib.masked.combobox.PreMas 


["wx.ControlwithItems", [ 
["wx.Choice",[ 
"wx.DirFilterListCtrl ",]], 
"wx.ListBox'", 
"wx.CheckListBox ",]], 
"wx.Gauge", 
"wx.GenericDirCtrl", 
"wx.gizmos.LEDNumberCtr1l", 
["wx.ListCtr1",[ 
"wx.ListView ",]], 
["wx.PyControl", [ 
"wx.lib.calendar.Calendar", 
["wx.lib.buttons.GenButton",[ 
["wx.lib.buttons.GenBitmapButt 


["wx.lib.buttons.GenBitm 


"wx.lib.buttons.Ge 


nBitmapTextToggleButton",]], 


pToggleButton ",]], 


n "™,]], 


]], 


"wx.lib.buttons.GenBitma 
"wx.lib.buttons.GenToggleButto 


wx.lib.statbmp.GenStaticBitmap", 

wx.lib.stattext.GenStaticText", 

"wx.lib.popupctl.PopButton", 

wx.lib.popupctl.PopupControl", 
"wx.lib.ticker.Ticker ",]], 

wx.RadioBox", 

"wx.RadioButton", 

"wx.ScrollBar", 

"wx.Slider", 

"wx.SpinButton", 

"wx.SpinCtrl", 

["wx.StaticBitmap", [ 
"wx.lib.fancytext.StaticFancyText ", 


extCtr1l1",[ 


dreti 


n 
, 


kedTextCtrl", 
[e 


rl ",]], 


"lL 


DTE 


"wx.StaticBox", 

"wx.StaticLine", 

"wx.StaticText", 

["wx.stc.StyledTextCtrl",[ 
["wx.py.editwindow.EditWindow", [ 


"wx.py.crust.Display", 

"wx. py.editor.EditWindow", 
"wx.py.filling.FillingText", 
"wx.py.shell.Shell",]], 


"wx.lib.pyshell.PyShellwindow ",]], 
["wx.TextCtr1", T 
["wx.lib.masked.textctrl.BaseMaskedT 


"wx.lib.masked.ipaddrctrl.IpAd 
"wx.lib.masked.numctrl.NumCtrl 
"wx.lib.masked.textctrl.PreMas 
"wx.lib.masked.textctrl.TextCt 


"wx.lib.masked.timectrl.TimeCt 


wx.py.crust.Calltip", 
wx.lib.sheet.CTextCellEditor", 
wx.py.crust.DispatcherListing", 
wx.lib.intctrl.IntCtrl", 


"wx.lib.rightalign.RightTextCtrl", 


wx.py.crust.SessionListing",]], 


"wx.ToggleButton", 

"wx.ToolBar", 

["wx.TreeCtr1",[ 
"wx.py.filling.FillingTree", 
"wx.gizmos.RemotelyScrolledTreeCtrl 


"wx.gizmos.TreeListCtrl ",]], 


wx.MenuBar", 


"wx.lib.multisash. 
"wx.lib.multisash. 
"wx.lib.multisash. 
"wx.lib.multisash. 
"wx.lib.multisash. 
"wx.lib.multisash. 
"wx.lib.multisash. 


["wx.Panel", [ 


wx.gizmos.DynamicSashWindow", 
"wx.lib.multisash. 
wx.glcanvas.GLCanvas", 
wx.lib.imagebrowser.ImageView'", 
wx.MDIClientWindow", 


EmptyChild", 


MultiClient", 
MultiCloser", 
MultiCreator", 
MultiSash", 
MultiSizer", 
MultiSplit", 
MultiViewLeaf", 


"wx.gizmos.EditableListBox", 
["wx.lib.filebrowsebutton.FileBrowseButton 


"wx, lib. filebrowsebutton.DirBrowseBu 
tton", 
"wx, lib. filebrowsebutton.FileBrowseB 
uttonWithHistory",]], 
"wx.lib.floatcanvas.FloatCanvas.FloatCanva 


um 
"wx.lib.floatcanvas.NavCanvas.NavCanvas'", 
"wx.NotebookPage", 
["wx.PreviewControlBar",[ 
"wx.PyPreviewControlBar ",]], 
"wx.lib.colourchooser.pycolourbox.PyColour 
Box", 


"wx.lib.colourchooser.pycolourchooser.PyCo 
lourChooser", 
["wx.PyPanel",[ 
"wx.lib.throbber.Throbber", ]], 
"wx.lib.shell.PyShell", 
"wx.lib.shell.PyShellInput", 
"wx.lib.shell.PyShellOutput", 
["wx.Scrolledwindow", [ 
"wx.lib.editor.editor.Editor", 
["wx.grid.Grid",[ 
"wx.lib.sheet.CSheet ",]], 
["wx.html.Htmlwindow", [ 
"wx.lib.ClickableHtmlWindow.Py 
ClickableHtmlWindow", ]], 
"wx.PreviewCanvas", 
"wx.lib.printout.PrintTableDraw", 
["wx.PyScrolledwindow", [ 
"wx.lib.scrolledpanel.Scrolled 
Panel",]], 
"wx.lib.ogl.ShapeCanvas", 
"wx.gizmos.SplitterScrolledWindow ", 
]], 
["wx.VScrolledwindow", [ 
["wx.VListBox", [ 
"wx.HtmlListBox ",]] ]], 
["wx.wizard.WizardPage", [ 
"wx.wizard.PyWizardPage", 
"wx.wizard.WizardPageSimple ",]], 
"wx.lib.plot.PlotCanvas", 
"wx.lib.wxPlotCanvas.PlotCanvas", 
["wx.PopupWindow", [ 
"wx.lib.foldmenu.FoldOutWindow", 
["wx.PopupTransientWindow",[ 
"wx.Tipwindow ",]] ]], 
["wx.PyWindow", [ 
"wx.lib.analogclock.AnalogClockWindow",]], 
"wx.lib.gridmovers.RowDragWindow", 
["wx.SashWindow", [ 
"wx.SashLayoutWindow ",]], 
"wx.SplashScreenWindow", 
["wx.SplitterWindow", [ 


"wx.py.crust.Crust", 
"wx. py.filling.Filling", 
"wx.gizmos.ThinSplitterWindow ",]], 
"wx.StatusBar", 
["wx.TopLevelWindow", [ 
["wx.Dialog",[ 


g", 


"wx.lib.calendar.CalenDlg", 
"wx.ColourDialog", 

wx.DirDialog", 

"wx.FileDialog", 
"wx.FindReplaceDialog", 
wx.FontDialog", 
wx.lib.imagebrowser.ImageDialog", 
"wx.MessageDialog", 
"wx.MultiChoiceDialog", 
"wx.lib.dialogs.MultipleChoiceDialog 


wx.PageSetupDialog", 
"wx.lib.popupctl.PopupDialog", 
wx.PrintDialog", 
"wx.lib.dialogs.ScrolledMessageDialo 


wx.SingleChoiceDialog", 
"wx.TextEntryDialog", 
wx.wizard.Wizard ",]], 


["wx.Frame", [ 


ionFrame", 


bookFrame", ]], 


"wx.lib.analogclockopts.ACCustomizat 


"wx.py.filling.FillingFrame", 
["wx.py.frame.Frame",[ 
"wx.py.crust.CrustFrame", 
["wx.py.editor.EditorFrame", [ 
"wx.py.editor.EditorNote 


"wx.py.shell.ShellFrame",]], 
wx.html.HtmlHelpFrame", 
"wx.MDIChildFrame", 
wx.MDIParentFrame", 
wx.MiniFrame", 
["wx.PreviewFrame", [ 

"wx.PyPreviewFrame ",]], 
wx.ProgressDialog", 
wx.SplashScreen", 
"wx.lib.splashscreen.SplashScreen", 
"wx.lib.masked.maskededit.test2", 
"wx.lib.plot.TestFrame ",]] ]], 


"wx.gizmos.TreeCompanionWindow ",]] 1] ll, 


wx.FileHistory", 
"wx.FileSystem", 
"wx.FindReplaceData", 
"wx.FontData", 
"wx.FontList", 
wx.FSFile", 


["wx.GDIObject", [ 
wx.Bitmap", 
wx.Brush", 
wx.Cursor", 
"wx.Font", 
wx.Icon", 
"wx.Palette", 
wx.Pen", 
wx.Region ",]], 
"wx.glcanvas.GLContext", 
["wx.grid.GridTableBase", [ 
"wx.grid.GridStringTable", 
"wx.grid.PyGridTableBase ",]], 
["wx.html.HtmlCell", [ 
"wx.html.HtmlColourCell", 
"wx.html.HtmlContainerCell", 
"wx.html.HtmlFontCell", 
"wx.html.HtmlwidgetCell", 
"wx.html.HtmlwordCell ",]], 
"wx.html.HtmlDCRenderer", 
"wx.html.HtmlEasyPrinting", 
"wx.html.HtmlFilter", 
"wx.html.HtmlLinkInfo", 
["wx.html.HtmlParser", [ 
"wx.html.HtmlwinParser ",]], 
"wx.html.HtmlTag", 
["wx.html.HtmlTagHandler", [ 
["wx.html.HtmlwinTagHandler", [ 
"wx.lib.wxpTag.wxpTagHandler ",]] ]], 
"wx.Image", 
["wx.ImageHandler", [ 
["wx.BMPHandler", [ 
["wx.ICOHandler", [ 
["wx.CURHandler", [ 
"wx.ANIHandler ",]] 1] J], 
"wx.GIFHandler", 
"wx.JPEGHandler", 
wx.PCXHandler", 
"wx.PNGHandler", 
"wx.PNMHandler", 
"wx.TIFFHandler", 
"wx.XPMHandler ",]], 
"wx.ImageList", 
"wx.IndividualLayoutConstraint", 
"wx.LayoutAlgorithm", 
["wx.LayoutConstraints", [ 
"wx.lib.anchors.LayoutAnchors", 
"wx.lib.layoutf.Layoutf",]], 
"wx.ListItem", 
"wx.Mask", 
"wx.MenuItem", 
"wx.MetaFile", 
"wx .PageSetupDialogData", 


wx.PenList", 

wx.PrintData", 

wx.PrintDialogData", 

wx.Printer", 

["wx.Printout", [ 
"wx.html.HtmlPrintout", 
"wx.lib.plot.PlotPrintout", 
"wx.lib.printout.SetPrintout ",]], 

["wx.PrintPreview", [ 
"wx.PyPrintPreview ",]], 

"wx.RegionIterator", 

["wx.Sizer", [ 

"wx.BookCtrlSizer", 

["wx.BoxSizer", [ 
"wx.StaticBoxSizer", ]], 

["wx.GridSizer", [ 
["wx.FlexGridSizer", [ 

"wx.GridBagSizer",]] ]], 

"wx .NotebookSizer", 

"wx.PySizer",]], 

["wx.SizerItem", [ 
"wx.GBSizerItem", |], 

wx.SystemOptions", 

wx.ToolBarToolBase", 

wx.ToolTip", 

wx.gizmos.TreeListColumnInfo", 

wx.xrc.XmlDocument", 
wx.xrc.XmlResource", 
wx.xrc.XmlResourceHandler ", 


如 何 添加 一 个 root( 根 ) 元 素 ? 


当 你 将 项 目 添加 到 树 时 ， 你 首先 必须 要 添加 的 项 目 是 root( 根 ) 元 素 。 添 加 根 元 素 
的 方法 如 下 所 示 : 


AddRoot(text, image=-1, selImage=-1, data=None) 


你 只 能 添加 一 个 根 元 素 。 如 果 你 在 已 经 存在 一 个 根 元 素 后 ， 再 添加 第 二 根 元 素 的 
话 ， 那 么 wxPython 将 引发 一 个 异常 。 其 中 的 参数 text 包含 用 于 根 元 素 的 显示 
字符 串 。 参 数 image 是 图 像 列 表 中 的 一 个 索引 ， 代 表 要 显示 在 参数 text FUN 
图 像 。 这 个 图 像 列表 将 在 15.5 节 中 作 更 详细 的 讨论 ， 但 是 现在 只 要 知道 它 的 行为 类 
似 于 用 于 列表 控件 的 图 像 列 表 。 参 数 data 是 一 个 与 项 目 相关 的 数据 对 象 ， 主 要 的 
目的 是 分 类 。 


AddRoot() 方法 返回 一 个 关于 根 项 目的 ID 。 树 形 控件 使 用 它 自己 的 
类 wx.TreeltemId 来 管理 项 目 。 在 大 多 数 时 候 ， 你 不 需要 关心 ID 的 具体 值 ， 你 
只 需要 知道 每 个 项 目 都 有 一 个 唯一 的 wx.TreeltemId 就 够 了 ， 并 且 这 个 值 可 以 使 


用 等 号 测试 。 wx.TreeItemId 不 映射 到 任何 简单 的 类 型 一 一 它 的 值 没 有 任何 的 关 
联 性 ， 因 为 你 只 是 把 它 用 于 相等 测试 。 


如 何 将 更 多 的 项 目 添加 到 树 中 ? 


一 旦 你 有 了 根 元 素 ， 你 就 可 以 开始 向 树 中 添加 元 素 了 。 用 的 最 多 的 方法 

是 AppendItem(parent, text, image- -1，selImage= -1, data-None) ° # 
& parent 是 已 有 的 树 项 目的 wx.TreelItemId ， 它 作为 新 项 目的 父亲 。 参 

数 text 是 显示 新 项 目的 文本 字符 串 。 参 数 image 和 ,Sellmage 的 意义 与 方 

法 AddRoot() 中 的 相同 。 该 方法 将 新 的 项 目 放置 到 其 父 项 目的 孩子 列表 的 末尾 。 
这 个 方法 返回 新 创建 的 项 目的 wx.TreeltemId 。 如 果 你 想 给 新 的 项 目 添加 子 项 目 
的 话 ， 你 需要 拥有 这 个 ID 。 一 个 示例 如 下 


rootId = tree.AddRoot("The Root") 
childId = tree.AppendItem(rootlId, "A Child") 
grandChildId = tree.AppendItem(childId, "A Grandchild") 


上 面 的 这 个 代码 片断 增加 了 一 个 root( 根 ) 项 目 ， 然 后 给 根 项 目 添加 了 一 个 子 项 
目 ， 然 后 给 子 项 目 添 加 了 它 的 子 项 目 。 


如 果 要 将 子 项 目 添 加 到 孩子 列表 的 开头 的 话 ， 使 用 方 


ik PrependItem(parent, text, image- -1, selImage= -1, data=None) 。 


如 果 你 想 将 一 个 项 目 插入 树 的 任意 点 上 ， 你 可 以 使 用 后 面 的 两 种 方法 之 一 。 第 一 个 
是 InsertItem(parent, previous, text,image= -1，selImage= -1, 
data=None) ° HY #2 previous 其 父 项 目 中 的 子 列表 中 的 项 目 

的 wx.TreeItemId 。 插 入 的 项 目 将 放置 在 该 项 目的 后 面 。 第 二 个 方法 

是 InsertItemBefore(parent, before, text, image= -1, selImage= -1, 
data=None) 。 该 方法 将 新 的 项 目 放置 在 before 所 代表 的 项 目 之 前 。 ae 

数 before 不 是 一 个 项 目的 ID 。 它 是 项 目 在 孩子 列表 中 的 整数 索引 。 个 方 
法 返回 新 项 目的 一 个 wx.TreeltemId 。 


如 何 管理 项 目 ? 


要 去 掉 树 中 的 一 个 项 目 ， 可 以 使 用 Delete(item) 方法 ， 其 中 参数 item 是 该 项 
目的 wx.TreeItemId 。 调 用 这 个 方法 将 导致 一 个 EVT TREE Delete ITEM 类 型 
的 树 的 事件 被 触发 。 后 面 的 章节 我 们 将 讨论 树 的 事件 类 型 。 要 删除 一 个 项 目的 所 有 
子 项 目 ， 而 留 下 该 项 目 自身 ， 可 以 使 用 方法 DeleteChildren(item) * 其 中 参 
数 item 也 是 一 个 wx.TreeItemId 。 该 方法 不 产生 一 个 删除 事件 。 要 清除 整个 
树 ， 使 用 方法 DeleteAllItems() 。 该 方法 为 每 个 项 目 生成 一 个 删除 事件 ， 但 
是 ， 这 在 某 些 老 版 的 Windows 系统 上 不 工作 。 


尔 将 一 个 项 目 添加 到 树 中 ， 你 就 可 以 使 用 方法 GetItemText(item) 来 得 到 该 
P P e 其 其 中 参数 item 是 一 个 wx.TreeItemId 。 如 果 你 想 改 
变 一 个 项 目的 显示 文本 ， 可 以 使 用 方法 SetItemText(item, text) ， 其 中 参 
数 item 是 一 个 wx.TreeltemId ， 参 数 text 是 一 个 新 的 显示 文本 。 


最 后 ， 你 可 以 使 用 方法 Getcount() 来 得 到 树 中 项 目的 总 数 。 如 果 你 想得到 特定 
项 目下 的 子 项 目的 数量 ， 可 以 使 用 方 

法 GetChildrenCount(item, recursively=True) 。 其 中 参数 item 是 一 

个 wx.TreeItemId ， 参 数 recursively 如 果 为 False ， 那 么 该 方法 只 返回 直 
接 的 子 项 目的 数量 ， 如 果 为 True ， 则 返回 所 有 的 子 项 目 而 不 关 齿 套 有 多 深 。 


树 控件 的 显示 样式 

树 控件 的 显示 样式 分 为 四 类 。 第 一 类 定义 了 树 中 显示 在 父 项 目的 文本 旁 的 按钮 (用 
So ee d vu ets 

15.1 树 控件 中 的 按钮 


按钮 。 在 Windows 上 ，+ 用 于 标明 项 目 可 以 被 展 
JF ^ -RR YTV E © 


wx.TR_NO_ BUTTONS 没有 按钮 。 


WX.TR HAS BUTTONS 


接 下 来 的 一 类 显示 在 表 15.2 中 ， 它 们 决定 树 控 件 将 连接 线 绘 制 在 何 处 。 
表 15.2 树 控 件 中 的 连接 线 


如 果 设 置 了 这 个 样式 ， 那 么 树 控件 将 在 多 

个 root 项 目 之 间 绘 制 连 线 。 注 意 ， 

X wx.TR HIDE ROOT 被 设置 了 ， 那 么 你 就 有 多 
个 root 项 目 。 


如 果 设 置 了 这 个 样式 ， 那 么 树 控件 将 不 在 兄弟 项 目 
wx.TR_NO_LINES 间 绘 制 连 接线 。 这 个 样式 将 代 
替 wx.TR LINES AT ROOT ° 


WX.TR LINES AT ROOT 


wXx.TR ROW LINES 树 控件 在 行 之 问 将 绘制 边 距 。 


第 三 类 样式 显示 在 表 15.3 中 ， 用 于 控制 树 控件 的 选择 模式 。 
表 15.3 树 控件 的 选择 模式 


wx. TR_EXTENDED 可 以 选择 多 个 不 连续 的 项 。 不 是 对 所 有 的 系统 有 效 。 
wx.TR MULTIPLE 可 以 选择 一 块 且 仅 一 块 连续 的 项 。 
wX.TR. SINGLE 一 次 只 能 选择 一 个 结 点 。 这 是 默认 模式 。 


表 15.4 显 示 了 其 它 的 一 样 可 作用 于 树 的 显示 的 样式 。 
表 15.4 树 的 其 它 显 示 样 式 


如 果 设 置 了 这 个 样式 ， 那 么 当 被 选择 

时 ， 被 选项 的 整 ESAT AT Fy OUR oo xk 
wx.TR. FULL ROW HIGHLIGHT 认 情 况 下 ， 只 是 文本 区 高 亮 。 

在 Windows 上 ， 该 样式 只 在 也 设 

E wx.NO LINES 时 有 效 。 


如 果 设 置 了 这 个 样式 ， 则 行 的 高 度 将 
根据 其 中 的 图 像 和 文本 而 不 同 。 否 
则 ， 所 有 的 行将 是 同样 的 高 度 (取决 
于 最 高 的 行 ) 。 

如 果 设 置 了 这 个 样式 ， 则 通 

过 AddRoot() 确定 的 root 元 素 将 
不 被 显示 。 此 时 该 结 节 的 所 有 子 项 就 
如 同 它 们 是 root 一 样 显示 。 这 个 样 
AJU-THE— AU RUE ZA root TH 
的 外 观 。 


WX.TR HAS VARIABLE ROW HEIGHT 


WX.TR HIDE ROOT 


最 后 ， wx.TR DEFAULT. STYLE 让 你 的 树 显示 出 最 接近 当前 操作 系统 本 地 控件 的 样 
式 。 在 程序 中 ， 你 可 以 使 用 Setwindowstyle(styles) 来 改变 样式 ， 其 中 参 
数 styles 是 你 想 要 的 新 样式 。 


树 形 控件 有 几 个 方法 可 以 用 以 改变 它 的 显示 特性 。 在 这 些 方法 中 ， 参 数 item 是 你 
想 要 改变 的 项 的 wx.TreeltemId 。 你 可 以 使 用 方 

法 SetItemBackgroundColor(item, col) 来 设置 项 目的 背景 色 ， 其 中 参 

数 col 是 一 个 wx.Colour 或 其 它 能 够 转换 为 磊 VERUM MEM. 

用 SetItemTextColour(item,col) 来 改变 文本 的 颜色 。 你 可 以 使 

用 SetItemFont(item, font) 来 设置 项 目的 显示 字体 ， 其 中 参数 font 是 一 

个 wx.Font 实例 。 如 果 你 只 想 显示 文本 为 粗 体 ， 你 可 以 使 用 方 

法 SetItemBold(item, bold-True) ， 其 中 参数 bold 是 一 个 布尔 值 ， 它 决定 是 
否 显示 为 粗 体 。 上 面 的 四 个 set 方法 都 有 对 应 的 get 方法 ， 如 下 所 示 : 
GetItemBackgroundColor(item), GetItemTextColour(item), GetItemFont(: 
fe IsBold(item) 。 其 中 的 item 参数 是 一 个 wx.TreeItemId ° 


对 树 形 控 件 的 元 素 排 友 


对 树 形 控件 的 元 素 排序 的 基本 机 制 是 方法 Sortchildren(item) 。 其 中 参 
数 item 是 wx.TreeltemId 的 一 个 实例 。 该 方法 对 此 项 目的 子 项 目 按 显示 字符 串 
的 字母 的 顺序 进行 排序 。 


对 于 树 的 排序 ， 每 个 树 项 目 都 需要 有 已 分 派 的 数据 ， 不 管 你 是 否 使 用 
默认 情况 中 ， 所 指派 的 数据 是 None ， 但 是 对 于 排序 任务 ， 在 树 控件 中 你 还 
显 式 地 设置 


在 15.1 节 ， 我 们 提 及 到 了 让 你 能 够 创建 一 个 树 项 目 及 将 该 项 目 与 一 个 任意 数据 对 象 
相关 联 的 方法 。 我 们 也 告诉 你 不 要 使 用 这 个 机 制 。 数 据 项 目 是 一 

个 wx.TreeItemData 。 在 wxPython 中 在 一 预定 义 的 快捷 的 方法 ， 使 你 能 够 用 以 
将 一 个 Python 对 象 与 一 个 树 项 目 关联 起 来 。 


快捷 的 set * 方 法 是 SetItemPyData(item, obj) 。 其 中 参数 item 是 一 

个 wx.TreeItemId ， 参 数 obj 是 一 个 任意 的 Python 对 象 ， wxPython ESE 
管理 这 个 关联 。 当 你 想得到 这 个 数据 项 时 ， 你 可 以 调用 GetItemPyData(item) ， 
它 返回 相关 的 Python 对 象 。 


注意 : 对 于 wx.TreeItemData 有 一 个 特别 的 构造 函 

dt: wx.TreeItemData(obj) ， 其 中 参数 obj 是 一 个 Python 对 象 。 因 此 你 可 
以 使 用 GetItemData(item) 和 SetItemData(item, obj) 方法 来 处 理 这 

个 Python 数据。 这 是 SetItemPyData() 方法 的 后 台 机 制 。 这 一 信息 在 某 些 时 
候 可 能 对 你 是 有 用 的 ， 但 是 大 部 分 时 候 ， 你 还 是 应 该 使 

用 SetItemPyData(item，obj) 和 GetItemPyData(item) 方法 。 


要 使 用 关联 的 数据 来 排序 你 的 树 ， 你 的 树 必 须 是 一 个 wx.TreeCtrl 的 自 定义 的 子 
类 ， 并 且 你 必须 覆盖 OnComparelItems(itemi, item2) 方法 。 其 中 参 

数 item1，item2 是 要 比较 的 两 个 项 的 wx.TreeItemId 实例 。 如 果 items 应 该 
HEE item2 的 前 面 ， 则 方法 返回 -1， 如 果 itemi 应 该 排 在 item2 的 后 面 ， 则 返 
回 1， 相 等 则 返回 0。 该 方法 是 在 当 树 控件 为 了 排序 而 比较 计算 每 个 项 时 自动 被 调用 
的 。 你 可 以 在 OncompareItems() 方法 中 做 你 想 做 的 事情 。 尤 其 是 ， 你 可 以 如 下 
调用 GetItemPyData() 方法 : 


def OnCompareItems(self, itemi, item2); 
data1 = self.GetItemPyData(item1) 
data2 = self.GetItemPyData(item2) 
return cmp(datai1, data2) 


控制 与 每 项 相关 的 图 像 


用 于 树 形 控件 的 图 像 是 由 一 个 图 像 列 表 来 维护 的 ， 这 非常 类 似 于 列表 控件 中 的 图 像 

维护 。 有 关 创 建 图 像 列表 的 细节 ， 参 见 13 章 。 一 旦 你 创建 了 图 像 列表 ， 你 就 可 以 使 

r SetImageList(imageList) 或 AssignImageList (imageList ) 方法 把 它 分 配 
给 树 控件 。 前 ARS 图 像 列表 可 以 被 其 它 控件 共享 ， 后 者 的 图 像 列 表 所 有 权 属 于 树 

" 件 。 之 后 ， 你 可 能 使 用 方法 GetImageList() 来 得 到 该 图 像 列 表 。 图 15.2 显 示 
vee en d 
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simple tree with icons (JEJ 





— wx.AcceleretorT able 
7 wx.BrushList 
— wx.Busyinfo 
wx.Clipboard 
= wx.Colour 
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— wx.ColourDatabase 
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7 wx.FontList 
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+ LJ wx.GDIObject 
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+ CJ wx.grid.GridTableBase 
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例 15.2 是 产生 图 15.2 的 代码 。 它 使 用 了 ArtProvider 对 象 来 提供 图 像 。 


例 15.2 一 个 带 有 图 标的 树 控件 


#-*- encoding:UTF-8 -*- 
import wx 
import data 
class TestFrame(wx.Frame): 
def _init_ (self): 
wx.Frame.__init__(self, None, 


title-"simple tree with icons", size=(400, 500) ) 


# 创建 一 个 图 像 列表 
il = wx.ImageList(16,16) 
# 添加 图 像 到 列表 
self.fldridx = il.Add( 
wx.ArtProvider.GetBitmap(wx.ART FOLDER, 
wX.ART. OTHER, (16,16))) 
self.fldropenidx - il.Add( 
wx.ArtProvider.GetBitmap(wx.ART FILE OPEN, 
wX.ART OTHER, (16,16))) 
self.fileidx - il.Add( 


wx.ArtProvider.GetBitmap(wx.ART NORMAL FILE, 


WX.ART OTHER, (16,16))) 


H 创建 树 

self.tree = wx.TreeCtrl(self) 

# 给 树 分 配 图 像 列表 
self.tree.AssignImageList(il) 

root = self.tree.AddRoot("wx.Object") 
self.tree.SetItemImage(root, self.fldridx, 


wx.TreeItemIcon_Normal)# 设置 根 的 图 


像 


self.tree.SetItemImage(root, self.fldropenidx, 


wx.TreeltemIcon Expanded) 


self .AddTreeNodes(root, data.tree) 
self.tree.Expand(root ) 


def AddTreeNodes(self, parentItem, items): 
for item in items: 
if type(item) == str: 
newItem = self.tree.AppendItem(parentItem, item) 
self.tree.SetItemImage(newItem, self.fileidx, 
wx. TreeItemIcon_Normal)# 
设置 数据 图 像 
else: 
newItem = self.tree.AppendItem(parentItem, item[ 
0]) 
self.tree.SetItemImage(newItem, self.fldridx, 
wx.TreeltemIcon Normal)Zz 
设置 结 点 的 图 像 
self.tree.SetItemImage(newItem, self.fldropenidx 


wx. TreeIltemIcon_Expanded ) 
self .AddTreeNodes(newItem, item[1] ) 


def GetItemText(self, item): 
if item: 
return self.tree.GetItemText (item) 
else: 
return "" 


app = wx.PySimpleApp(redirect-True) 
frame = TestFrame() 

frame.Show( ) 

app .MainLoop( ) 


如 你 所 见 ， 当 你 添加 项 目 到 列表 中 时 ， 对 于 未 选 和 选中 状态 ， 有 两 个 不 同 的 图 像 可 
用 于 分 配给 项 目 。 和 列表 控件 一 样 ， 你 可 以 指定 图 像 在 图 像 列表 中 的 索引 。 如 果 你 
想 在 项 目 被 创建 后 得 到 所 分 配 的 图 像 ， 你 可 以 使 用 方 

法 GetItemImage(item, which=wx.TreeItemIcon_Normal) ° Xv 

数 item 是 项 目的 wx.TreeItemId ° Až which 控制 你 将 得 到 了 是 哪个 图 像 ， 
默认 值 wx.TreeItemIcon_Normal ， 将 得 到 该 项 目的 未 选 状态 的 图 像 的 索 

引 。 which 的 另 一 个 值 wx.TreeItemIcon_Selected 的 使 用 ， 将 返回 选中 状态 
的 图 

像 ， wx.TreeItemIcon_Expanded 和 wxTreeltemIcon SelectedExpanded 3% 
回 当 该 树 项 目 被 展开 时 所 使 用 的 图 像 。 注 意 ， 后 者 的 两 个 图 像 不 能 使 用 添加 方法 来 
被 设置 如 果 你 想 设 置 的 话 ， 你 必须 使 用 方 

法 SetItemImage(item, image, which=wx.TreeItemIcon_Normal) 来 实现 。 其 
中 参数 item 是 wx.TreeItemId 的 实例 ， 参 数 image 是 新 图 像 的 整数 索引 ， 参 
数 which 同 get * 方 法 。 





使 用 编程 的 方式 访问 树 。 


在 15.1 节 中 ， 我 们 谈 到 没有 直接 得 到 一 个 给 定 项 目的 子 项 目的 Python 列表 的 方 
法 ， ETSEAN H m dec. 。 要 实现 这 个 ， 我 们 需要 使 用 本 节 所 
说 的 遍历 方法 来 访问 树 的 结 点 。 


要 开始 遍历 树 ， cS Er 来 得 到 根 元 素 。 该 方法 返回 树 的 


根 元 素 的 wx.TreeItemId ， 你 就 可 以 使 用 诸 
如 GetItemText() 或 rs 之 类 的 方法 来 获取 关于 根 元 素 的 更 多 的 
信息 。 


一 旦 你 得 到 了 一 个 项 目 ， 你 就 可 以 通过 选 代 器 来 遍历 子 项 目的 列表 。 你 可 以 使 用 广 
法 Seer Greet 来 得 到 子 树 中 的 第 一 个 孩子 ， 该 方法 返回 一 个 二 元 元 组 
( child, cookie) 。 参 数 item 是 第 一 个 孩子 的 wx.TreelItemId 。 除 了 告诉 你 
每 一 个 孩子 是 什么 外 ， 该 方法 还 初始 化 一 个 选 代 对 象 ， 该 对 象 使 你 能 够 遍历 该 

Bo cookie 值 只 是 一 个 标志 ， 它 使 得 树 控件 能 够 同时 保持 对 多 个 迭代 器 的 跟踪 ， 


而 它们 之 间 不 会 彼此 干扰 。 


一 旦 你 由 GetFirstChild() 得 到 了 cookie ， 你 就 可 以 通过 反复 调 

用 GetNextchild(item, cookie) 来 得 到 其 余 的 孩子 。 这 里 的 item 父 项 

的 ID ， cookie 是 由 GetFirstChild() 或 前 一 个 GetNextChild() 调用 返回 

的 。 GetNextchild() 方法 也 返回 一 个 二 元 元 组 ( child, cookie) 。 如 果 此 时 没 
有 下 一 个 项 目 了 ， 那 么 你 就 到 达 了 和 孩子 列表 的 末尾 ， 系 统 将 返回 一 个 无 效 的 孩 

F ID 。 你 可 以 通过 使 用 wx.TreeItemId.IsOk() 或 nonzero 方法 测试 这 

种 情况 。 下 面 的 函数 返回 给 定 项 目的 所 有 和 孩子 的 文本 的 一 个 列表 。 


def getChildren(tree, parent): 
result = [] 
item, cookie = tree.GetFirstChild(parent) 
while item: 
result.append(tree.GetItemText (item) ) 
item, cookie = tree.getNextChild(parent, cookie) 
return result 


这 个 函数 得 到 给 定 父 项 目的 第 一 个 孩子 ， 然 后 将 第 一 个 孩子 的 文本 添加 到 列表 中 ， 
然后 通过 循环 来 得 到 每 个 子 项 目的 文本 并 添加 到 列表 中 ， 直 到 得 到 一 个 无 效 的 项 ， 
这 时 就 返回 result 。 


要 得 到 父 项 目的 最 后 一 个 孩子 ， 你 可 以 使 用 方法 GetLastchild(item) ， 它 返回 

列表 中 的 最 后 的 项 目的 wx.TreeItemId 。 由 于 这 个 方法 不 用 于 驱动 迭代 器 来 遍历 
整个 孩子 列表 ， 所 以 它 不 需要 cookie Tut] aS o n 到 

它 的 父 项 ， 可 以 使 用 方法 GetItemParent(item) 来 返回 给 定 项 的 父 项 的 ID ° 


你 可 以 使 用 方法 GetNextSibling(item) 和 GetPrevSibling(item) 来 在 同 级 
的 项 目 间 前 后 访问 。 这 些 方法 均 返 回 相 关 项 的 wx.TreeItemId 。 由 这 些 方法 同样 
不 用 于 驱动 迭代 器 ， 所 以 它们 都 不 需要 一 个 cookie 。 当 你 已 经 到 达 列 表 的 两 头 


时 ， 将 没有 下 一 项 或 前 一 项 ， 那 么 这 些 方法 将 返回 一 个 无 效 的 项 〈 例 
如 : item.IsOk() == False ) 。 


要 确定 一 个 项 是 否 有 孩子， 使 用 方法 ItemHaschildren(item) ， 该 方法 返回 布尔 
值 True 或 False 。 你 可 以 使 用 方 

法 SetItemHasChildren(item, hasChildren=True) 来 将 一 个 项 设置 为 有 子 

项 ， 如 果 这 样 ， 即 使 该 项 没有 实际 的 子 项 ， 它 也 将 显示 得 与 有 子 项 的 一 样 。 也 就 是 
说 该 项 旁边 会 有 一 个 扩展 或 折 王 的 按钮 ， 以 便 展 开 或 折 王 。 这 通常 被 用 于 实现 一 个 
虚 的 树 控件 。 这 个 技术 将 在 15.7 节 中 演示 。 


管理 树 中 的 选择 


树 形 控件 允许 你 通过 程序 的 方式 管理 树 中 的 被 选项 。 基 本 的 方法 

是 SelectItem(item, select=True) 。 在 单 选 树 控件 中 ， 该 方法 将 选择 指定 

项 item ( wx.TreeItemId ) ， 同 时 自动 撤消 对 先前 选项 的 选择 。 如 果 参 

数 select 的 取 值 是 False ， 那 么 该 方法 将 取消 对 参数 item 代表 的 项 的 选择 。 
在 一 个 可 多 选 的 树 控 件 中 ， SelectItem() 方法 只 改变 item 所 代表 的 项 的 状 
态 ， 而 不 改变 树 中 其 它 项 的 选择 状态 。 在 可 多 选 的 树 中 ， 你 也 可 以 使 用 方 

法 ToggleItemSelection(item) ， 它 只 切换 参数 item 所 代表 项 的 选择 状态 。 


对 于 取消 选择 还 有 三 个 快捷 的 方法 。 方 法 Unselect() 取消 单 选 模 式 树 中 的 当前 
被 选项 的 选择 。 在 多 选 模式 树 中 ， 使 用 UnselectAll() 来 取消 所 有 的 选择 。 如 果 
你 只 想 取 消 在 一 个 多 选 树 中 的 一 个 项 的 被 选 状态 ， 可 以 使 用 方 

法 UnselectItem(item) 。 


你 也 可 以 使 用 方法 IsSelected(item) 来 查询 一 个 项 目的 选择 状态 ， 该 方法 返回 
布尔 值 True 或 False 。 对 于 单 选 树 ， 你 可 能 使 用 方法 GetSelection() 来 得 
到 当前 被 选项 目的 wx.TreeItemId 。 对 于 多 选 树 ， 可 以 使 用 方 

法 GetSelections() 来 得 到 所 有 被 选项 的 wx.TreeItemId 的 一 个 Python 列 
表 o 


当 树 控件 中 发 生 选择 变化 的 时 候 ， 有 两 个 事件 将 被 触发 并 可 被 捕获 。 第 一 个 事件 
是 wx.EVT_TREE_SEL_CHANGING， 它 在 被 选项 实际 改变 之 前 发 生 。 如 果 你 要 处 理 
这 个 事件 ， 你 可 以 使 用 事件 的 Veto() 方法 来 阻止 选择 的 改变 。 在 选择 已 经 改变 之 
后 ， 事 件 wx.EVT. TREE SEL CHANGED 被 触发 。 这 两 个 事件 的 类 

是 wx.TreeEvent ， 这 将 在 15.8 节 中 作 更 完整 的 讨论 。 


控制 项 目的 可 见 性 


在 树 控 件 中 有 两 种 机 制 可 以 让 你 用 编程 的 方式 控制 某 项 目的 可 见 性 。 你 可 以 使 用 方 
法 Collapse(item) 和 Expand(item) 指定 给 定 的 树 项 目 是 展开 的 或 折 司 的。 这 
些 方法 改变 树 控 件 的 显示 ， 并 且 如 果 对 一 个 没有 子 项 的 项 目 调用 该 方法 将 不 起 作 
用 。 这 儿 还 有 一 个 方便 的 函数 : CollapseAndReset(item) ° AY kit Eia gig 
项 ， 并 删除 指定 项 的 所 有 和 孩子。 另外 ， 方 法 Toggle(item) 用 于 切换 项 目的 展开 
和 折 滞 状态 。 你 可 以 使 用 方法 IsExpanded(item) 来 查询 项 目的 当前 展开 状态 。 


RAR BPH A ARRAS RRA RA ERE o X 

件 wx.EVT. TREE ITEM COLLAPSING 或 wx.EVT. TREE ITEM EXPANDING 被 触发 。 
在 你 的 处 理 方法 中 ， 你 可 以 使 用 事件 的 veto() JARLAR o ERR 
HERE? X 

4+ EVT TREE ITEM COLLAPSED 或 wx.EVT. TREE ITEM EXPANDED 被 触发 。 这 四 

个 事件 都 是 类 wx.TreeEvent 的 事件 类 型 。 


È 
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时 添加 。 例 15.3 显 示 这 样 一 个 样 列 。 


例 15.3 展开 时 动态 添加 新 的 项 目 














#-*- encoding:UTF-8 -*- 
import wx 
import data 
class TestFrame(wx.Frame): 
def — init (self): 
wx.Frame. init (self, None, title="virtual tree with i 
cons", size=(400, 500) ) 
il = wx.ImageList(16,16) 
self.fldridx = il.Add( 
wx.ArtProvider .GetBitmap(wx.ART_FOLDER, wx.ART_OTHER 
, (16,16))) 
self.fldropenidx = il.Add( 
wx.ArtProvider.GetBitmap(wx.ART FILE OPEN, WX.ART 
OTHER, (16,16))) 
self.fileidx = il.Add( 
wx.ArtProvider.GetBitmap(wx.ART NORMAL FILE, wXx.ART 
OTHER, (16,16))) 
self.tree = wx.TreeCtrl(self) 
self.tree.AssignImageList(il) 
root = self.tree.AddRoot ("wx.Object") 
self.tree.SetItemImage(root, self.fldridx, 
wx.TreeltemIcon Normal) 
self.tree.SetItemImage(root, self.fldropenidx, 
wx.TreeltemIcon Expanded) 


# Instead of adding nodes for the whole tree, just attac 


h some 

# data to the root node so that it can find and add its 
child 

# nodes when it is expanded, and mark it as having child 
ren so 


# it will be expandable. 
self.tree.SetItemPyData(root, data.tree)# 创 建 一 个 根 
self.tree.SetItemHasChildren(root, True) 


# Bind some interesting events 
# BSH 
self.Bind(wx.EVT TREE ITEM EXPANDED, self .OnItemExpanded 





, self.tree) 

self.Bind(wx.EVT TREE ITEM COLLAPSED, self.OnItemCollaps 
ed, self.tree) 

self.Bind(wx.EVT TREE SEL CHANGED, self.OnSelChanged, se 
lf.tree) 

self.Bind(wx.EVT TREE ITEM ACTIVATED, self.OnActivated, 
self.tree) 

self.Bind(wx.EVT TREE ITEM EXPANDING, self.OnItemExpandi 
ng, self.tree) 

self.tree.Expand(root) 











def AddTreeNodes(self, parentItem):425 3 BH Im tk% 


Add nodes for just the children of the parentItem 
items = self.tree.GetItemPyData(parentItem) 
for item in items: 
if type(item) == str: 
# a leaf node 
newItem = self.tree.AppendItem(parentItem, item) 
self.tree.SetItemImage(newItem, self.fileidx, 
wx.TreeltemIcon Normal) 
else: 
# this item has children 
newItem = self.tree.AppendItem(parentItem, item[ 
9] ) 
self.tree.SetItemImage(newItem, self.fldridx, 
wx.TreeltemIcon Normal) 
self.tree.SetItemImage(newItem, self.fldropenidx 


wx.TreeltemIcon Expanded) 
self.tree.SetItemPyData(newItem, item[1]) 
self.tree.SetItemHasChildren(newItem, True) 


def GetItemText(self, item): 
if item: 
return self.tree.GetItemText(item) 
else: 
return "" 
def OnItemExpanded(self, evt): 
print "OnItemExpanded: ", self.GetItemText(evt.GetItem() 


def OnItemExpanding(self, evt):#2 RAN 6| E 45 A 
# When the item is about to be expanded add the first le 
vel of child nodes 
print "OnItemExpanding:", self.GetItemText(evt.GetItem() 
) 


self.AddTreeNodes(evt.GetItem()) 


def OnItemCollapsed(self, evt): 
print "OnItemCollapsed:", self.GetItemText(evt.GetItem() 


# And remove them when collapsed as we don't need them a 
ny longer 
self.tree.DeleteChildren(evt.GetItem())#47 2 NMR & 
def OnSelChanged(self, evt): 
print "OnSelChanged: ", self.GetItemText(evt.GetItem() ) 
def OnActivated(self, evt): 
print "OnActivated: ", self.GetlItemText(evt.GetItem()) 
app = wx.PySimpleApp(redirect-True) 
frame = TestFrame() 
frame. Show( ) 
app .MainLoop( ) 


这 个 机 制 可 以 被 扩展 来 从 外 部 源 读 取 数据 以 查看 。 这 个 机 制 除 了 可 以 被 用 来 建造 一 
个 文件 树 外 ， 我 们 会 提 及 数据 库 中 的 数据 的 可 能 性 ， 以 便 对 文件 的 结构 不 感 趣 的 你 
不 用 全 面 研究 文件 结构 。 


控制 可 见 性 


有 大 量 的 方法 使 你 能 够 管理 那些 项 目 是 可 见 的 。 一 个 对 象 的 不 可 见 ， 可 能 是 因为 它 
没 处 在 含有 滚动 条 的 框 中 的 可 见 区 域 或 是 因为 它 处 在 折 王 项 中 。 你 可 以 使 

用 IsVisible(item) 方法 来 确定 项 目 是 否 可 见 ， 该 方法 在 项 目 是 可 见 时 返 

回 True ， 不 可 见 返 回 False 。 你 可 以 通过 使 用 方法 EnsureVisible(item) i 
使 指定 的 项 变 成 可 见 的 。 如 果 需 要 的 话 ， 该 方法 将 通过 展开 该 项 的 父 项 (以 及 父 项 
的 父 项 ， 以 此 类 推 ) 来 迫使 指定 项 变 成 可 见 的 ， 然 后 滚动 该 树 ， 以 使 指定 项 处 于 控 
件 的 可 见 部 分 。 如 果 你 只 需要 滚动 ， 可 以 使 用 ScrollTo(item) 方法 来 完成 。 


遍历 树 中 的 可 见 部 分 ， 首 先 要 使 用 的 方法 是 GetFirstVisibleItem() 。 该 方法 返 
回 显示 的 可 见 部 分 中 的 最 顶端 的 项 目的 wx.TreeItemId 。 然 后 通过 使 

用 GetNextVisible(item) 方法 来 遍历 ， 该 方法 的 item 参数 来 

自 GetFirstVisibleItem() 和 GetNextVisible() 的 返回 值 。 如 果 移 动 的 方向 
向 上 的 话 ， 使 用 方法 GetPreviousVisible(item) 。 如 果 参 数 item 不 可 见 的 
话 ， 返 回 值 是 一 个 无 效 的 项 。 


还 有 几 个 别 的 方法 可 用 于 项 目的 显示 。 树 控件 有 一 个 属性 ， 该 属性 用 于 设置 缩 进 。 
可 以 通过 方法 GetIndent() 和 方法 SetIndent(indent) 来 得 到 和 设置 该 属性 的 
当前 值 。 其 中 indent 参数 是 缩 进 的 像素 值 (整数 ) 。 


要 得 到 关于 指定 点 的 树 项 目的 信息 ， 使 用 方法 HitTest(point) ， 其 中 point 是 
树 控件 中 的 相关 位 置 的 一 个 wx.Point 。 方 法 的 返回 值 是 一 个 ( item, flags) 元 
且 ， 其 中 的 item 是 相关 位 置 的 项 的 wx.TreeItemId 或 None 值 。 如 果 指 定位 置 
没有 项 目 ， 那 么 一 个 无 效 的 项 目 将 返回 。 flags 部 分 是 一 个 位 掩 码 ， 它 给 出 了 相 
关 的 信息 。 表 15.5 包 含 了 flags 的 一 个 完整 列表 。 


还 有 两 个 方法 ， 它 们 让 你 可 以 处 理 屏幕 上 项 目的 实际 的 边界 。 方 
法 GetBoundingRect(item, textOnly=False) 返回 一 个 wx.Rect 实例 ， 该 实 
例 对 应 于 屏幕 上 文本 项 的 矩形 边界 区 域 。 其 中 参数 item 是 项 目 
的 wx.TreeItemId 。 如 果 参 数 textonly 为 True ， 那 么 该 矩形 仅 包 括 项 目的 


2 区 域 。 如 果 为 False ， 那 么 该 矩形 也 包括 图 像 区 域 。 在 这 两 种 
OUP >» F276 SB Ede PEA 3h RS P AY RHA AY ZEE] DOES o oR item R 
表 的 项 目 当 前 是 不 可 见 的 ， 那 么 两 种 方法 都 返回 None 。 


表 15.5 

该 位 置 在 树 的 客户 区 的 上 面 ， 不 是 
任何 项 目的 一 部 分 

该 位 置 在 树 的 客户 区 的 下 面 ， 不 是 
任何 项 目的 一 部 分 

该 位 置 和 ， 不 是 任 
何 项 目的 一 部 分 


该 位 置 位 于 展开 / 折 生 图 标 按钮 上 ， 
是 项 目的 一 部 分 


WX.TREE HITTEST ABOVE 


WX.TREE HITTEST BELOW 


wX.TREE HITTEST NOWhere 


WX.TREE HITTEST ONITEMBUTTON 


wx. TREE_HITTEST_ONITEMICON 该 位 置 位 于 项 目的 图 像 部 分 上 。 

wx. TREE_HITTEST_ONITEMINDENT 该 位 置 位 于 项 目的 显示 文本 的 左 
缩 进 区 域 中 。 

wx. TREE_HITTEST_ONITEMLABEL 位 置 位 于 项 目的 显示 文本 中 。 

wx . TREE_HITTEST_ONITEMRIGHT 该 位 置 是 项 目的 显示 文本 的 右边 。 

wx. TREE_HITTEST_ONITEMSTATEICON 位 置 是 在 项 目的 状态 图 标 中 。 


面 ， 不 是 
任何 项 目的 一 部 分 


该 位 置 在 树 的 客户 区 的 右面 ， 不 是 
任何 项 目的 一 部 分 
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WX.TREE HITTEST TORIGHT 


使 树 控件 可 编辑 


树 控 件 可 以 被 设置 为 允许 用 户 编辑 树 项 目的 显示 文本 。 这 通过 在 创建 树 控件 时 使 用 
样式 标记 wx.TR EDIT LABELS 来 实现 。 使 用 了 该 样式 标记 后 ， 树 控件 的 行为 就 类 
似 于 可 编辑 的 列表 控件 了 。 编 辑 一 个 树 项 目 会 给 出 一 个 文本 控件 来 让 用 户 编辑 文 
本 。 按 下 esc 则 取消 编辑 。 按 下 回 车 键 或 在 文本 控件 外 敲 击 将 确认 编辑 。 


你 可 以 在 程序 中 使 用 EditLabel(item) 方法 来 启动 对 特定 项 的 编辑 。 参 

dt item 是 你 想 要 编辑 的 项 的 wx.TreeltemId 。 要 终止 编辑 ， 可 以 使 用 方 

法 EndEditLabel(cancelEdit) 。 由 于 一 次 只 oo o > 所 以 这 里 不 
需要 指定 项 目的 ID 。 参 数 cancelEdit 是 一 个 布尔 值 。 如 果 为 True ， 取 消 编 
辑 ， 如 果 为 False ， 则 不 取消 。 如 果 因 为 某 种 原因 ， 你 需要 访问 当前 所 用 的 文本 


编辑 控件 ， 你 可 以 调用 方法 GetEditControl() ， 该 方法 返回 用 于 当前 编辑 

的 wx.TextCtrl 实例 ， 如 果 当 前 没有 编辑 ， 则 返回 None 。 当 前 该 方法 只 工作 

于 Windows 系统 下 。 

当 一 个 编辑 会 话 开 始 时 (通过 用 户 选 择 或 调用 EditLabel() 方 

ik) ， wx.EVT TREE BEGIN LABEL EDIT 类 型 的 wx.TreeEvent 事件 被 触发 。 

如 果 使 用 veto() 方法 否决 了 该 事件 的 话 ， 那 么 编辑 将 不 会 开始 。 当 会 话 结束 时 
(通过 用 户 的 敲 击 或 调用 EndEditLabel() 方法 ) ， 一 

个 wx.EVT_TREE_END_LABEL_EDIT 类 型 的 事件 被 触发 。 这 个 事件 也 可 以 被 否决 ， 
这 样 的 话 ， 编 辑 就 被 取消 了 ， 项 目 不 会 被 改变 。 


响应 树 控件 的 其 它 的 用 户 事件 
在 这 一 节 ， 我 们 将 讨论 wx.TreeEvent 类 的 属性 。 表 15.6 列 出 了 这 些 属性 。 
表 15.6 wx.TreeEvent 的 属性 


返回 所 按键 的 整数 按键 码 。 只 对 wx.EVT TREE KEY. 


GetKeyCode() 果 任 一 修饰 键 ( CTRL, SHIFT,and ALT 之 类 的 ) 也 
你 。 
GetItem() 返回 与 事件 相关 的 项 的 wx.TreeltemId 。 


只 对 wx.EVT TREE KEY DOWN 事件 有 效 。 返 回 wx. 
被 用 来 告知 你 在 该 事件 期 间 ， 是 否 有 修饰 键 被 按 下 。 


返回 项 目的 当前 文本 标签 。 只 


GetKeyEvent( ) 


GetLabel() 对 wx.EVT TREE BEGIN LABEL EDIT 和 wx. EVT TI 
GetPoint() 返回 与 该 事件 相关 的 和 鼠标 位 置 的 一 个 wx.Point ° F 


只 对 wx.EVT. TREE END LABEL EDIT 有 效 。 如 果 用 


IsEditcancelled() 编辑 则 返回 True > GIAE False © 


只 对 wx.EVT. TREE ITEM GETTOOLTIP X44 2% ° ù 
的 提示 。 该 属性 只 作 在 Windows 系统 上 。 





SetToolTip(tooltip) 


表 15.7 列 出 了 几 个 不 适合 在 表 15.6 中 列 出 的 wx.TreeEvent 的 事件 类 型 ， 它 们 有 时 
也 是 用 的 。 


表 15.7 树 控 件 的 另外 的 几 个 事件 


当 用 户 通过 按 下 和 鼠标 左 键 来 拖 动 树 中 的 
一 个 项 目 时 ， 触 发 该 事件 。 要 让 拖 动 时 
能 够 做 些 事情 ， 该 事件 的 处 理 函 数 必 须 
显 式 地 调用 事件 的 Allow() 方法 。 


当 用 户 通 过 按 下 鼠标 右键 来 拖 动 树 中 的 
一 个 项 目 时 ， 触 发 该 事件 。 要 让 拖 动 时 
能 够 做 些 事情 ， 该 事件 的 处 理 函 数 必 须 
显 式 地 调用 事件 的 Allow() 方法 。 


当 一 个 项 目 通过 双击 被 激活 时 ， 触 发 该 
事件 。 


当 和 鼠标 停留 在 树 中 的 一 个 项 目 上 时 ， 触 
发 该 事件 。 该 事件 可 用 来 为 项 目 设置 特 
wx.EVT. TREE. ITEM GETTOOLTIP 定 的 提示 。 只 需要 在 事件 对 像 中 简单 地 
设置 标签 参数 ， 其 它 的 将 由 系统 来 完 
Jo 
在 树 控件 获得 焦点 的 情况 下 ， 当 一 个 键 
被 按 下 时 触发 该 事件 。 


wxX.EVT_TREE BEGIN DRAG 


WX.EVT TREE BEGIN RDRAG 


wXx.EVT TREE ITEM ACTIVATED 








WX.EVT TREE KEY DOWN 


上 面 这 些 就 你 需要 了 解 的 有 关 树 控件 的 属性 。 下 面 ， 我 们 将 通过 一 个 有 用 的 另 一 种 
形式 的 树 控件 来 结束 本 章 。 


使 用 树 列表 控件 


除了 wx.TreeCtrl > wxPython 也 提供 了 wx.gizmos.TreeListCtrl ， 它 是 树 
控件 和 报告 模式 的 列表 控件 的 组 合 。 除 了 本 章 中 所 讨论 的 wx.Treectrl 的 特性 
外 ，TreeListCtrl 能 够 显示 与 每 行 相关 的 数据 的 附加 列 。 图 15.3 显 示 了 树 列表 
控件 的 样子 。 


图 15.3 
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TreeListCtri ales 





















A descéption of wx Accelerator Table 

一 wo Brushist A desception of wx. Brushilst 

wx Busyrio A descspton of wx Busyinfo 
— we Cipbosnd A desception of wx Clipboard 
^ we Colour A descspton of wx Colour 
— wxColourData A desception of wx ColcurData 
— wxColurDatabsse A descaption of wx ColcurDatabase 
— we ContedHelp A desception of wx ContedHelp 
SHI wx Dc A descepton of wx.DC 
7 wx Drag nage A descéption of wx Draginage 
— we Effects A descaption of wx. Effects 

wx EncodingConverter A descspton of wx EncodingConverter 
可 辐 wx Event A desception of wx. Event 
SHI wx ExtHender A desception of wx Evi Hander 
— wx PleHstory A descaption of wx. FicHitory 
— we. FileSysten A descaption of wx. FileSystem 
— wxhndReplaceDota A desception of wx RindReplaceData 
— wxFontDeta A descepton of wx. FontDesta 
wx Pont List A descéption of wx Font List 
一 wxFSFie A desception of wx. F SFe 
EHI wx GDIObieat A descspton of wx GDlObiect 
一 wxgcanwas GlContest A desception of wx.gicanas GlContest 
(SC wxgndGridTsbleBase —— Adescspton of wx.gid GédTableBase w 

a ò 2 
例 15.4 是 产生 上 图 的 代码 


例 15.4 使 用 树 列 表 控 件 


import wx 
import wx.gizmos 
import data 
class TestFrame(wx.Frame): 
def — init (self): 
wx.Frame. init (self, None, title="TreeListCtrl", size 
=(400,500) ) 
# Create an image list 
il = wx.ImageList(16,16) 
# Get some standard images from the art provider and add 
them 
# to the image list 
self.fldridx = il.Add( 
wx.ArtProvider.GetBitmap(wx.ART FOLDER, wx.ART_OTHER 
, (16,16))) 
self.fldropenidx - il.Add( 
wx.ArtProvider.GetBitmap(wx.ART FILE OPEN, WX . ART 
OTHER, (16,16))) 
self.fileidx = il.Add( 
wx.ArtProvider.GetBitmap(wx.ART NORMAL FILE, wx.ART_ 
OTHER, (16,16))) 


# Create the tree 
# 创建 树 列 表 控 件 
self.tree = wx.gizmos.TreeListCtrl(self, style = 
WX.TR DEFAULT STYLE 
| wx. TR FULL ROW HIGH 
LIGHT) 
# Give it the image list 
self.tree.AssignImageList(il) 


# create some columns 

# 创 建 一 些 列 
self.tree.AddColumn("Class Name") 
self.tree.AddColumn("Description") 
self.tree.SetMainColumn(0) # the one with the tree in it 


self.tree.SetColumnWidth(0, 200) 

self.tree.SetColumnwidth(1, 200) 

# Add a root node and assign it some images 

root = self.tree.AddRoot("wx.Object") 

self.tree.SetItemText(root, "A description of wx.Object" 

， 工 )# 给 列 添加 文本 

self.tree.SetItemImage(root, self.fldridx, 
wx.TreeltemIcon Normal) 

self.tree.SetItemImage(root, self.fldropenidx, 
wx.TreeltemIcon Expanded) 


# Add nodes from our data set 

self.AddTreeNodes(root, data.tree) 

# Bind some interesting events 

self.Bind(wx.EVT TREE ITEM EXPANDED, self .OnItemExpanded 
, self.tree) 

self.Bind(wx.EVT TREE ITEM COLLAPSED, self.OnItemCollaps 
ed, self.tree) 

self.Bind(wx.EVT TREE SEL CHANGED, self.OnSelChanged, se 
lf.tree) 

self.Bind(wx.EVT TREE ITEM ACTIVATED, self.OnActivated, 
self.tree) 

4 Expand the first level 

self.tree.Expand(root) 











def AddTreeNodes(self, parentItem, items): 
Recursively traverses the data structure, adding tree nodes to 
match it. 
for item in items: 
if type(item) -- str: 
newItem = self.tree.AppendItem(parentItem, item) 
self.tree.SetItemText(newItem, "A description of 
9s" % item， 工 )# 给 列 添加 文本 
self.tree.SetItemImage(newItem, self.fileidx, 
wx.TreeltemIcon Normal) 
else: 
newItem = self.tree.AppendItem(parentlItem, item[ 


9] ) 
self.tree.SetItemText(newItem, "A description of 
%s" 96 item[0], 1) 
self.tree.SetItemImage(newItem, self.fldridx, 
wx.TreeltemIcon Normal) 
self.tree.SetItemImage(newItem, self.fldropenidx 


wx.TreeltemIcon Expanded) 


self .AddTreeNodes(newItem, item[1] ) 


def GetItemText(self, item): 
if item: 
return self.tree.GetItemText (item) 
else: 
return "" 


def OnItemExpanded(self, evt): 
print "OnItemExpanded: ", self.GetlItemText(evt.GetItem() 


def OnItemCollapsed(self, evt): 
print "OnItemCollapsed:", self.GetlItemText(evt.GetItem() 


def OnSelChanged(self, evt): 
print "OnSelChanged: ", self.GetItemText(evt.GetItem() ) 
def OnActivated(self, evt): 
print "OnActivated: ", self.GetItemText(evt.GetItem()) 
app = wx.PySimpleApp(redirect-True) 
frame = TestFrame() 
frame.Show() 
app.MainLoop() 


树 列表 控件 的 很 多 方法 和 列表 控件 的 相似 ， 所 以 我 们 就 再 也 没有 列 出 并 说 明了 。 


本 章 小 结 


1、 树 控件 提供 给 你 了 一 个 如 文件 树 或 XML ASHE MRE RRA PML o BY FEHR E 
类 wx.Treectrl 的 实例 。 有 时 ， 人 你 会 想 子 类 化 wx.TreeCtrl ， 尤 其 是 如 果 你 
需要 实现 自 定义 的 排序 的 时 候 。 


2、 要 向 树 中 添加 项 目 ， 首 先 要 用 方法 AddRoot(text, image= -1, 

selImage= -1, data=None) 。 该 函数 的 返回 值 是 一 个 代表 树 的 root RA 

的 wx,TreeItemId 。 树 控件 使 用 wx.TreertemId 作为 它 自己 的 标识 符 类 型 ， 而 
非 和 其 它 控件 一 样 使 用 整数 的 ID 。 一 旦 你 得 到 了 root 项 ， 你 就 可 以 使 用 方 

法 AppendItem(parent, text, image- -1, selImage= -1, data-None) 来 添 
加 子 项 目 ， 参 数 parent 是 父 项 目的 ID 。 该 方法 返回 新 项 目 

的 wx.TreeItemId 。 另 外 还 有 一 些 用 来 将 新 的 项 目 添加 在 不 同位 置 的 方法 。 方 
法 Delete(item) 从 树 中 移 除 一 个 项 目 ， 方 法 DeleteChildren(item) 移 除 指定 
项 的 所 有 子 项 目 。 


、 树 控件 有 一 些 用 来 改变 树 的 显示 外 观 的 样式 。 一 套 是 用 来 控制 展开 或 折 受 项 目 
ir 另 一 套 是 用 来 控制 项 目 间 的 连接 线 的 。 第 三 套 是 用 于 控制 树 是 单 选 
还 是 多 选 的 。 你 也 可 以 使 用 样式 通过 隐藏 树 的 实际 的 root ， 来 模拟 一 个 有 着 多 
个 root 项 的 树 « 


4、 默 认 情 况 下 ， 树 的 项 目 通 常 是 按照 显示 文本 的 字母 顺序 排序 的 。 但 是 要 使 这 能 

够 实现 ， 你 必须 给 每 项 分 配 数据 。 实 现 这 个 的 最 容易 的 方法 是 使 

用 SetItemPyData(item, obj) ， 它 给 项 目 分 配 一 个 任意 的 Python 对 象 。 如 果 
你 想 使 用 该 数据 去 写 一 个 自 定 义 的 排序 函数 ， 你 必须 继承 wx.Treectrl X #8 X 
方法 OnCompareItems(itemi, item2) ， 其 中 的 参数 items 和 item2 是 要 比 

较 的 项 的 ID 。 


5、 树 控件 使 用 一 个 图 像 列 表 来 管理 图 像 ， 类 似 于 列表 控件 管理 图 像 的 方法 。 你 可 
以 使 用 SetImageList(imageList) 或 AssignImageList(imageList) 来 分 配 一 
个 图 像 列表 给 树 控 件 。 然 后 ， 当 新 的 项 目 被 添加 到 列表 时 ， 你 可 以 将 它们 与 图 像 列 
表 中 的 特定 的 索引 联系 起 来 。 


6、 没 有 特定 的 函数 可 以 让 你 得 到 一 个 父 项 的 子 项 目 列表 。 替 而 代 之 的 是 ， 你 需要 
去 遍历 子 项 目 列表 ， 这 通过 使 用 方法 GetFirstchild(item) 作为 开始 。 


7、 你 可 以 使 用 方法 SelectItem(item，select=True) 来 管理 树 的 项 目的 选择 。 
在 一 个 多 选 树 中 ， 你 可 以 使 用 ToggleItemSelection(item) 来 改变 给 定 项 的 状 
态 。 你 可 以 使 用 IsSelected(item) 来 查询 一 个 项 目的 状态 。 你 也 可 以 使 

用 Expand(item) 或 Collapse(item) 展开 或 折 引 一 个 项 ， 或 使 

用 Toggle(item) 来 切换 它 的 状态 。 


8、 样 式 wx.TR EDIT LABELS 使 得 树 控件 可 为 用 户 所 编辑 。 一 个 可 编辑 的 列表 

中 ， 用 户 可 以 选择 一 个 项 ， 并 键入 一 个 新 的 标签 。 按 下 esc 来 取消 编辑 而 不 对 项 
目 作 任何 改变 。 你 也 可 以 通过 wx.EVT TREE END LABEL EDIT 事件 来 否决 编辑 。 
类 wx.TreeEvent 提供 了 允许 访问 当前 被 处 理 的 项 目的 显示 文本 的 属性 。 


第 十 六 章 在 应 用 程序 中 加 入 HTML 


本 章 内 容 : 
e 在 wxPython 窗口 中 显示 HTML 
e 处 理 和 打印 HTML 窗口 
e 使 用 HTML 分 析 器 ( parser) 
e 支持 新 的 标记 和 其 它 的 文件 格式 
e 在 HTML 中 使 用 控件 


HTML 最 初 是 打算 被 作为 超 文本 系统 使 用 的 一 个 简单 的 语义 标记 来 使 用 的 。 迄 今 为 
Jb» HTML 已 经 变 得 更 加 的 复杂 和 被 广泛 使 用 。 HTML 文档 标记 已 经 被 证 明 在 网 
页 浏览 器 之 外 也 是 有 用 的 。 目 前 HTML 文档 标记 通常 被 用 于 文本 标记 (如 在 文本 控 
TP) ， 或 用 于 管理 一 系列 的 超 链接 页 面 (帮助 系统 中 ) 。 在 wxPython 中 ， 有 许 
多 专用 于 处 理 你 的 HTML 需求 的 特性 。 你 可 以 在 一 个 窗口 中 显示 简单 的 HTML ， 
并 用 超 链接 创建 你 自己 的 帮助 页 面 ， 如 果 你 需要 的 话 ， 其 至 你 还 可 以 诅 入 一 个 功能 


更 全 的 浏览 器 。 


下 一 节 内 容 提 示 : 如 何在 wxPython 窗口 中 显示 HTML ? 


显示 HTML 


在 wxPython 中 ， 你 对 HTML 能 做 的 最 重要 的 事情 就 是 将 它 显 示 在 一 个 窗口 中 。 
下 面 的 两 节 ， 我 们 将 讨论 HTML 窗口 对 象 ， 以 及 给 你 展示 如 何 对 本 地 的 文本 或 远程 
的 URL 使 用 它 。 


如 何在 一 个 wxPython 窗 口中 显示 HTML? 
正如 我 们 在 第 六 章 中 讨论 的 ， 对 于 使 用 样式 文本 或 简单 的 网 格 来 快速 地 描述 文本 的 
布局 ，wxPython 中 的 HTML 是 一 个 有 用 的 机 


制 。 wxPython 的 wx.html.Htmlwindow 类 就 是 用 于 此 目的 的 。 图 16.1 显 示 了 一 
个 例子 。 


图 16.1 


Simple HTML 


Here is some formatted text 
loaded from a string 





Figure 16.1 A very simple 
HtmiWindow 


例 16.1 显 示 了 用 于 产生 图 16.1 的 代码 。 
例 16.1 显示 简单 地 HtmLwindow 


import wx 


import wx.html 


class MyHtmlFrame(wx.Frame): 
def — init (self, parent, title): 
wx.Frame. init__(self, parent, -1, title) 
html = wx.html.Htmlwindow(self) 
if "gtk2" in wx.PlatformInfo: 
html.SetStandardFonts( ) 


html.SetPage( 
"Here is some b formatted /b i ü text /u wu x 
"loaded from a font color=\"red\" string /font .") 


app = wx.PySimpleApp() 

frm = MyHtmlFrame(None, "Simple HTML") 
frm.Show() 

app.MainLoop() 


wx.html.Htmlwindow 的 构造 函数 基本 上 是 与 wx.Scrolledwindow 相同 的 ， 如 
下 所 示 : 


wx. html.HtmlWindow(parent, id=-1, pos=wx.DefaultPosition, 
size=wx.DefaultSize, style-wx.html.HW SCROLLBAR AUTO, 
name-"htmlWindow") 


上 面 的 这 些 参数 现在 看 着 应 该 比 熟悉 。 这 最 重要 的 不 同 点 是 默认 样 

X wx.html.HW_SCROLLBAR_AUTO ， 它 将 告诉 HTML 窗口 在 需要 的 时 候 自动 增加 
滚动 条 。 与 之 相反 的 样式 是 wx.html.HW_SCROLLBAR_NEVER ， 使 用 该 样式 将 不 会 
显示 滚动 条 。 还 有 一 个 HTML 窗口 样式 是 wx.html.HW NO SelectION ， 它 使 得 
用 户 不 能 选择 窗口 中 的 文本 。 


当 在 HTML 窗口 中 写 要 显示 的 HTML 时 ， 记 住所 写 的 HTML 要 是 简单 的 。 

为 wx.html.Htmlwindow 控件 仅 设 计 用 于 简单 样式 文本 显示 ， 而 非 用 于 全 功能 的 
多 媒体 超 文 本 系统 。 它 只 支持 最 基本 的 文本 标记 ， 更 高 级 的 特性 如 层 司 样式 表 
(css) 和 JavaScript 不 被 支持 。 表 16.1 包 含 了 官方 支持 的 HTML 标记。 通常 ， 
这 里 的 标记 和 它 的 属性 的 行为 和 web 浏览 器 中 的 一 样 ， 但 是 由 于 它 不 是 一 个 完全 
成 熟 的 浏览 器 ， 所 以 有 时 会 出 现 一 些 奇 怪 行为 的 情况 。 表 16.1 中 列 出 了 后 跟 有 属性 
的 标记 。 


表 16.1 用 于 HTML 窗口 控件 的 有 效 的 标记 


文档 结构 标记 a href na 
link text meta content http-equiv title 

文本 结构 标记 br div al 
文本 显示 标记 address b 
code em font color face size hi h2 h3 h4 h5 h6 


i kbd pre samp small strike string tt u 


列表 标记 dd dl dt 
图 像 和 地 图 标记 area coor 
height src width usemap map name 

表格 标记 table ali 


cellspacing valign width td align bgcolor colspan 
rowspan valign width nowrap th align bgcolor colspan 


valign width rowspan tr align bgcolor valign 


HTML 窗口 使 用 wx.Image 来 装载 和 显示 图 像 ， 所 以 它 可 以 支持 所 
有 wx.Image 支持 的 图 像 文件 格式 。 


如 何 显示 来 自 一 个 文件 或 URL 的 HTML ? 


一 旦 你 创建 了 一 个 HTML 窗口 ， 接 下 来 就 是 在 这 个 窗口 中 显示 HTML 文本 。 下 面 
的 四 个 方法 用 于 在 窗口 中 得 到 HTML 文本 。 

e SetPage(source) 

e AppendToPage(source) 

e LoadFile( filename) 


e LoadPage(location) 


其 中 最 直接 的 方法 是 SetPage(source) >? #% source 是 一 个 字符 串 ， 它 包含 你 
想 显示 在 窗 口中 的 HTML 资源 。 


你 可 以 使 用 方法 AppendToPage(source) 添加 HTML 到 窗口 中 的 文本 的 后 面 。 
于 setPage() 和 AppendToPage() 方法 ， 其 中 的 参数 source 被 假设 

是 HTML ， 这 意味 着 ， ， 如果 你 传递 的 是 纯 文本 ， 那 么 其 中 的 间距 将 被 忽略 ， 以 符 
合 HTML 标准 。 


如 果 你 想 让 你 的 窗口 在 浏览 外 部 的 资源 时 更 像 一 个 浏览 器 ， 那 么 你 有 两 种 方法 。 方 
法 LoadFile(filename) 读 取 本 地 文件 的 内 容 并 将 它们 显示 在 窗口 中 。 due 
JU: HUI MIME 文件 类 型 来 装载 一 个 图 像 文件 或 一 个 HTML. 文件 。 如 果 


能 确定 文件 是 何 种 类 型 ， 那 么 它 将 以 纯 文 本 的 方式 装载 该 文件 。 如 果 被 装载 的 文 
aud uc > 那么 被 用 于 解析 那些 链接 的 位 置 是 原文 件 的 
位 置 。 


当然 ， 一 个 实际 的 浏览 器 不 会 只 局 限于 本 地 文件 。 你 可 以 使 用 方 

A STEMS e 载 一 个 远程 的 URL ， 其 中 参数 location 是 一 
个 URL ， 但 是 对 于 本 地 文件 ， 它 是 一 个 路 径 名 。 MIME 类 型 的 URL 被 用 来 决定 

Kido rake 载 。 本 章 的 稍 后 部 分 ， 我 们 将 讨论 如 何 增加 对 新 文件 类 型 的 支持 。 


图 16.2 显 示 了 被 装载 入 HTML 窗口 中 的 一 个 页 面 
图 16.2 
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例 16.2 显 示 了 产生 图 16.2 的 代码 
例 16.2 从 一 个 web 页 装载 HTML 窗口 的 内 容 


import wx 
import wx.html 


class MyHtmlFrame(wx.Frame): 
def _init__(self, parent, title): 
wx.Frame. init (self, parent, -1, title, size=(600, 400 
)) 
html = wx.html.Htmlwindow(self) 
if "gtk2" in wx.PlatformInfo: 
html.SetStandardFonts() 


wx.CallAfter ( 
html.LoadPage, "http://www.wxpython.org") 


app - wx.PySimpleApp() 

frm - MyHtmlFrame(None, "Simple HTML Browser") 
frm.Show() 

app.MainLoop() 


例 16.2 中 关键 的 地 方 是 方法 LoadPage() 。 拥 有 更 完整 特性 的 浏览 器 窗口 
示 URL 的 文本 框 ， 并 在 当 用 户 键入 一 个 新 的 URL 后 ， 可 以 改变 窗口 中 的 


管理 HTML 窗 口 


一 旦 你 有 了 一 个 HTML 窗口 ， 你 就 可 以 通过 不 同 的 方法 来 管理 它 。 你 可 以 根据 用 户 
的 输入 来 触发 相应 的 动作 ， 处 理 窗口 的 内 容 ， 自 动 显示 有 关 窗 口 的 信息 和 打印 页 面 
等 。 在 随后 的 几 节 中 ， 我 们 将 讨论 如 何 实现 这 些 。 


如 何 响 应 用 户 在 一 个 链接 上 的 敲 击 ? 


wx.html.Htmlwindow 的 用 处 不 只 限于 显示 。 还 可 以 用 于 响应 用 户 的 输入 。 在 这 
种 情况 下 ， 你 不 需要 定义 你 自己 的 处 理 器 ， 你 可 以 在 你 
的 wx.html.Htmlwindow $9 F X FA 5 Ab38 HA o 


表 16.2 说 明了 已 定义 的 处 理子 数 。 wx.html.HtmlWwindow 类 没有 使 用 事件 系统 定 
义 事件 ， 所 以 你 必须 使 用 这 些 重 载 的 成 员 有 也 数 来 处 理 相关 的 事件 ， 而 非 绑 定 事件 类 


型 。 


另外 ， 如 果 你 想 让 一 个 HTML 窗口 响应 用 户 的 输入 ， 你 必须 创建 你 自己 的 子 类 并 覆 


表 16.2 wx.html.Htmlwindow 的 事件 处 理 函 数 


当 用 户 在 HTML CH PRAM S e 
表 所 显示 的 文档 的 一 部 分 ， 诸 如 文本 
OnCellClicked(cell, x, y, event) 析 器 创建 ， 这 将 在 本 章 后 部 分 讨论 。 
数 event 是 相关 的 息 标 敲 击 事件 。- 
单 地 委托 给 OnLinkClicked() ° € 


OnCellMouseHover(cell, x, y) 当 和 鼠标 经 过 一 个 HTML 单元 时 调用 。 


当 用 户 在 一 个 超 链接 上 敲 击 时 调用 。 
. : 方法 通常 用 于 使 用 Htmlwindow 来 
OnLinkClicked(link) 行为 以 便 用 户 通过 敲 击 其 中 的 主页 来 


M- ae 
W, 2s ° 


当 用 户 请 求 打 开 一 个 URL 时 调用 ，: 
是 wx.html.HTML URL PAGE, wx.h 
OnOpeningURL(type, url) 该 方法 返回 下 列 值 之 一 一 一 wx.htm: 
载 入 资源 ;或 用 于 URL 重 定向 的 一 个 
默认 版 总 是 返回 wx.html.HTML OPE 


OnSetTitle(title) 3 HTML 源 文件 中 有 title 标记 时 


如 何 使 用 编程 的 方式 改变 一 个 HTML 窗 口 ? 


当 你 正 显示 一 个 HTML 页 时 ， 你 还 可 以 改变 你 的 窗口 像 浏 览 器 样 去 显示 其 它 的 内 
容 ， 如 一 另 一 个 web 页 ， 或 帮助 文件 或 其 它 类 型 的 数据 ， 以 响应 用 户 的 需要 。 


有 两 个 方法 来 当 HTML 窗口 在 运行 时 ， 访 问 和 改变 HTML 窗口 中 的 信息 。 首 先 ， 
你 可 以 使 用 GetopenedPage() 方法 来 得 到 当前 打开 的 页 面 的 URL 。 该 方法 只 在 
当前 页 是 被 LoadPage() 方法 装载 的 才 工作 。 如 果 是 这 样 的 ， 那 么 方法 的 返回 值 
是 当前 页 的 URL 。 否 则 ， 或 当前 没有 打开 的 页 面 ， 该 方法 返回 一 个 空 字符 囊 。 另 
一 个 相关 的 方法 是 Get0penedAnchor() ， 它 返回 当前 打开 页 面 中 的 锚 点 

( anchor ) 。 如 果 页 面 不 是 被 LoadPage() 打开 的 ， 你 将 得 到 一 个 空 的 字符 

$ o 

要 得 到 当前 页 的 HTML 标题 ， 可 以 使 用 方法 GetOpenedPageTitle() ， 这 将 返回 
当前 页 的 title 标记 中 的 值 。 如 果 当 前 页 没有 一 个 title 标记 ， 你 将 得 到 一 个 
空 的 字符 束 。 

这 儿 有 几 个 关于 改变 窗口 中 文本 的 选择 的 方法 。 方 法 SelectAll() 选择 当前 打开 
的 页 面 中 的 所 有 文本 。 你 可 以 使 用 SelectLine(pos) 或 Selectword(pos) 做 更 
有 针对 性 的 选择 。 其 中 pos 是 鼠标 的 位 置 wx,Point ， 这 两 个 方法 分 别 选 择 一 行 
或 一 个 词 。 要 取得 当前 选择 中 的 纯 文本 内 容 ， 可 以 使 用 方 

法 SelectionToText() ， 而 方法 ToText() 返回 整个 文档 的 纯 文本 内 容 。 
wx.html.Htmlwindow 维护 着 历史 页 面 的 一 个 列表 。 使 用 下 表 16.3 中 的 方法 ， 可 
以 如 通常 的 浏览 器 一 样 浏览 这 个 历史 列表 。 


表 16.3 


装载 历史 列表 中 的 前 一 项 。 如 果 不 存 在 则 返 
False ° 


如 果 历 史 列 表 中 存在 前 一 项 ， 则 返回 True > € 
则 返回 False 。 


如 果 历 史 列 表 中 存在 下 一 项 ， 则 返回 True > F 
则 返回 False 。 


HistoryBack( ) 
HistoryCanBack() 


HistoryCanForward() 


HistoryClear() 清空 历史 列表 。 


ES 装载 历史 列表 中 的 下 一 项 。 如 果 不 存 在 则 返 
= False œ 

要 改变 正在 使 用 的 字体 ， 可 以 使 用 方 

法 SetFonts(normal face, fixed face, sizes-None) 。 参 

数 normal face 是 你 想 用 在 窗口 显示 中 的 字体 的 名 字 字 符 串 。 如 

果 normal face 是 一 个 空 字符 串 ， 则 使 用 系统 默认 字体 。 参 数 fixed face 指定 

固定 宽度 的 文本 ， 类 似 于 pre 标记 的 作用 。 如 果 指 定 了 fixed face 人 参数， 那么 

参数 sizes 则 应 是 一 个 代表 字体 的 绝对 尺寸 的 包含 7 个 整数 的 列表 ， 它 对 应 

于 HTML 逻辑 字体 尺寸 (如 font 标记 所 使 用 的 ) 一 24 之 间 。 如 果 该 参数 没有 指 

定 或 是 None ， 则 使 用 默认 的 。 关 于 默认 常量 wx.html.HTML FONT SIZE n ，n 

位 于 1~7 之 间 。 这 些 默 认 常 量 指定 了 对 应 于 HTML 逻辑 字体 尺寸 所 使 用 的 默认 字 





体 。 准 确 的 值 可 能 因 不 同 的 底层 系统 而 不 同 。 要 选择 一 套 基于 用 户 的 系统 的 字体 和 
尺寸 ， 可 以 调用 SetstandardFonts() ° RÆ GTK2 下 运行 wxPython 时 是 特别 
有 用 的 ， 它 能 够 提供 一 套 更 好 的 字体 。 


如 果 由 于 茶 种 原因 ， 你 需要 改变 窗口 中 文本 边缘 与 窗口 边缘 之 间 的 间隔 的 
话 ， HTML 窗口 定义 了 SetBorders(b) 方法 。 参 数 b 是 间隔 的 像素 宽度 (整数 
值 ) 。 


如 何在 窗口 的 标题 栏 中 显示 页 面 的 标题 ? 


在 你 的 web 浏览 器 中 ， 你 可 能 也 注意 到 了 一 件 事 ， 那 就 是 浏览 器 中 不 光 只 有 显示 

窗口 ， 还 有 标题 栏 和 状态 栏 。 通 常 ， 标 题 栏 显示 打开 页 面 的 标题 ， 状 态 栏 在 鼠标 位 
于 链接 上 时 显示 链接 信息 & o Æ wxPython 中 有 两 个 便捷 的 方法 来 实现 这 些 。 图 16.3 
对 此 作 了 展示 。 窗 口 显示 的 标题 是 基于 web 页 面 的 标题 的 ， 状 态 栏 文本 也 来 

É Html 窗口 。 


例 16.3 是 产生 图 16.3 的 代码 。 
图 16.3 带 有 状态 栏 和 标题 栏 的 HTML 窗口 
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116.3 从 一 个 web ARA HTMLWindow 4) A X 


#-*- encoding:UTF-8 -*- 
import wx 
import wx.html 


class MyHtmlFrame(wx.Frame): 
def _init__(self, parent, title): 
wx.Frame.__init__(self, parent, -1, title, size=(600, 400 


)) 
self .CreateStatusBar () 
html = wx.html.Htmlwindow( self ) 
if "gtk2" in wx.PlatformInfo: 
html.SetStandardFonts( ) 
html.SetRelatedFrame(self, self.GetTitle() + " -- %s") # 
关联 HTML 到 框架 


html.SetRelatedStatusBar(0) # 关 联 HTML 到 状态 栏 


wx.CallAfter ( 
html.LoadPage, "http://www.wxpython.org") 


app = wx.PySimpleApp() 

frm = MyHtmlFrame(None, "Simple HTML Browser") 
frm. Show() 

app .MainLoop( ) 


要 设置 标题 栏 的 关联 ， 使 用 方法 SetRelatedFrame(frame, format) ° # 

Jt frame 你 想 显示 页 面 标题 的 框架 。 参 数 format 是 你 想 在 框架 的 标题 栏 中 显示 
的 字符 串 。 通 常 的 格式 是 这 样 :“ My wxPython Browser: %s”。:%s 前 面 的 字符 
串 可 以 是 你 想 要 的 任何 字符 串 ，%s 将 会 被 HTML 页 面 的 标题 所 取代 。 在 窗口 中 ， 
一 个 页 面 被 载 入 时 ， 框 架 的 标题 自动 被 新 的 页 面 的 信息 取代 。 


要 设置 状态 栏 ， 使 用 方法 SetRelatedStatusBar(bar) 。 该 方法 必须 

在 SetRelatedFrame() 之 后 调用 。 参 数 bar 是 状态 栏 中 用 于 显示 状态 信息 的 位 
置 。 通 常 它 是 0， 但 是 如 果 状 态 栏 中 存在 多 个 显示 区 域 ， 那 么 bar 可 以 有 其 它 的 

值 。 如 果 bar 的 取 值 为 一 1, 那 么 不 显示 任何 信息 。 一 旦 与 状态 栏 的 关联 被 创建 ， 

那么 当 息 标 移动 到 显示 的 页 面 的 链接 上 时 ， 相 关 链 接 的 URL 将 显示 在 状态 栏 中 。 


如 何 打 印 一 个 HTML 页 面 ? 
一 旦 HTML 被 显示 在 屏幕 上 ， 接 下 来 可 能 做 的 事 就 是 打印 该 HTML 。 


类 wx.html.HtmlEasyPrinting 就 是 用 于 此 目的 的 。 你 可 以 使 用 下 面 的 构造 函数 
来 创建 wx.html.HtmlEasyPrinting 的 一 个 实例 : 


wx. html.HtmlEasyPrinting(name="Printing", parentWindow=None) 


参数 name 只 是 一 个 用 于 显示 在 打印 对 话 框 中 的 字符 串 。 参 数 parentwindow 如 
果 被 指定 了 ， 那 么 parentWindow 就 是 这 些 打印 对 话 框 的 父 窗口 。 如 

果 parentwindow A None ， 那 么 对 话 框 为 顶级 对 话 框 。 你 只 应 该 创 

建 wx.html.HtmlEasyPrinting 的 一 个 实例 。 尽 管 wxPython 系统 没有 强制 要 这 
样 做 ， 但 是 该 类 是 被 设计 为 独自 存 的 。 


使 用 wx.html.HtmlEasyPrinting 的 实例 


从 该 类 的 名 字 可 以 看 出 ， 它 应 该 是 容 多 使 用 的 。 首 先 ， 通 过 使 

用 PrinterSetup() 和 PageSetup() 方法 ， 你 能 够 给 用 户 显 示 用 于 打印 设置 的 

对 话 框 。 调 用 这 些 方法 将 导致 相应 的 对 话 框 显示 给 用 户 。 实 例 将 存储 用 户 所 做 的 设 
置 ， 以 备 后 用 。 如 果 你 想 访 问 这 些 设置 数据 ， 以 用 于 你 自己 特定 的 处 理 ， 你 可 以 使 
用 方法 GetPrintData() 和 GetPageSetupData() 。 GetPrintData() 方法 返 
回 一 个 wx.PrintData 对 象 ， GetPageSetupData() 方法 返回 

一 wx.PageSetupDialogData 对 象 ， 我 们 将 在 第 17 章 中 更 详细 地 讨论 。 


设置 字体 


你 可 以 使 用 方法 SetFonts(normal face, fixed face, sizes) 来 设置 打印 所 使 
用 的 字体 。 这 个 方法 的 行为 同 用 于 HTML 窗口 的 SetFonts() 相同 (在 打印 对 象 
中 的 设置 不 会 影响 到 HTML 窗口 中 的 设置 ) 。 你 可 以 使 用 方 

法 SetHeader(header, pg) 和 SetFooter(footer, pg) X /& fe Ji Bp o K 

# header 和 footer 是 要 显示 的 字符 串 。 字 符 串 中 你 可 以 使 用 点 位 符 

@ PAGENUM @ > 占 位 符 在 执行 时 被 打印 的 页 号 替代 。 你 也 可 以 使 用 

@ PAGENUM @ 占 位 符 ， 它 是 打印 的 页 面 总 数 。 参 数 pg 的 取 值 可 以 是 这 三 

个 : wx.PAGE ALL ^ wx.PAGE_EVEN 或 wx.PAGE ODD 。 它 控制 页 眉 和 页 脚 显示 
在 哪个 页 上 。 通 过 对 不 同 的 pg 参数 多 次 调用 该 方法 ， 可 以 为 奇数 页 和 偶数 页 设置 
单独 的 页 届 和 页 脚 。 


输出 预览 


如 果 在 打印 前 ， 你 想 预 览 一 下 输出 的 结果 ， 你 可 以 使 

用 PreviewFile(htmlfile) 方法 。 在 这 种 情况 下 ， 参 数 htmlfile 是 你 本 地 的 
包含 HTML 的 文件 的 文件 名 。 另 一 是 PreviewText(htmlText, basepath= "") ° 
参数 htmlText 是 你 实际 想 打 印 的 HTML ° basepath 文件 的 路 径 或 URL 。 如 
预览 成 功 ， 这 两 个 方法 均 返 回 True ， 否 则 返回 False 。 如 果 出 现 了 错误 ， 那 么 
全 局 方法 wx.Printer.GetLastError() 将 得 到 更 多 的 错误 信息 。 关 于 该 方法 的 
更 详细 的 信息 将 在 第 17 章 中 讨论 。 


打印 


现在 你 可 能 想 知 道 如 何 简 单 地 打印 一 个 HTML 页 面 。 方 法 就 

是 PrintFile(htmlfile) 和 PrintText(htmlText, basepath) 。 其 中 的 参数 
同 预览 方法 。 所 不 同 的 是 ， 这 两 个 方法 使 用 对 话 框 中 的 设置 直接 让 打印 机 打印 。 打 
印 成 功 ， 则 返回 True 。 


7 /& HTML 4 2 


在 这 一 节 ， 我 们 将 给 你 展示 如 何 处 理 HTML 窗口 中 的 HTML 标记 ， 如 何 创 造 你 自 
己 的 标记 ， 如 何在 HTML PRA wxPython 控件 ， 如 何 处 理 其 它 的 文件 格式 ， 以 
及 如 何在 你 的 应 用 程序 中 创建 一 个 真实 的 HTML 浏览 器 。 


HTML 解 析 器 (parsen) 是 如 何 工作 的 ? 


在 wxPython T > HTML 窗口 有 它 自己 内 在 的 解析 器 。 实 际 上 ， 这 里 有 两 个 解析 
器 类 ， 但 是 其 中 的 一 个 是 另 一 个 的 改进 。 通 常 ， 使 用 解析 器 工作 仅 在 你 想 扩 

展 wx.html.Htmlwindow 自身 的 功能 时 有 用 。 如 果 你 正在 使 用 Python 编程 ， 并 
基于 其 它 的 目的 想 使 用 一 个 HTML 解析 器 ， 那 么 我 们 建议 你 使 用 随同 Python 发 
AMAJ htmllib 和 HTMLParser 这 两 个 解析 器 模块 之 一 ， 或 一 个 外 部 

的 Python 工具 如 “ Beautiful Soup "» 


两 个 解析 器 类 分 别 是 wx.html.HtmlParser ， 它 是 一 个 更 通用 的 解析 器 ， 另 一 个 
是 wx.html.HtmlwinParser ， 它 是 wx.html.HtmlParser 的 子 类 ， 增 加 了 对 
在 wx.html.Htmlwindow 中 显示 文本 的 支持 。 由 于 我 们 所 关注 的 基本 上 


日 


是 HTML 窗口 ， 所 以 我 们 将 重点 关注 wx.html.HtmlWinParser 。 


要 创建 一 个 HTML 解析 器 ， 可 以 使 用 两 个 构造 函数 之 一 。 其 中 基本 的 一 个 

是 wx.html.HtmlwinParser() ， 没 有 参数 。 wx.html.HtmlwinParser 的 父 

类 wx.html.HtmlParser 也 有 一 个 没有 参数 的 构造 函数 。 你 可 以 使 用 另 一 个 构造 
函数 wx.html.HtmlwinParser(wnd) 将 一 个 wx.html.HtmlwinParser() 与 一 个 
已 有 的 wx.html.Htmlwindow 联系 在 一 起 ， 参 数 wnd 是 HTML 窗口 的 实例 。 


要 使 用 解析 器 ， 最 简单 的 方法 是 调用 Parse(source) 方法 。 参 数 source 是 要 被 
处 理 的 HTML 字符 串 。 返 回 值 是 已 解析 了 的 数据 。 对 于 一 
个 wx.html.HtmlwinParser ， 返 回 值 是 类 wx.html.HtmlCell 的 一 个 实例 。 


HTML 解析 器 将 HTML 文本 转换 为 一 系列 的 单元 ， 一 个 单元 可 以 表示 一 些 文本 ， 
一 个 图 像 ， 一 个 表 ， 一 个 列表 ， 或 其 它 特 定 的 元 素 。 wx.html.dtmlcell 的 最 重 
要 的 子 类 是 wx. html.dtmlcontainerCell ， 它 是 一 个 可 以 包含 其 它 单元 在 其 中 
的 一 个 单元 ， 如 一 个 表 或 一 个 带 有 不 同文 本 样式 的 段落 。 对 于 你 解析 的 几乎 任何 文 
档 ， 返 回 值 都 将 是 一 个 wx.html.HtmlContainerCell 。 每 个 单元 都 包含 一 
个 Draw(dc, x, y, view_y1, view y2) 方法 ， 这 使 它 可 以 在 HTML 窗口 中 自动 
绘制 它 的 信息 。 


另 一 个 重要 的 子 类 单元 是 wx.html.dtmlwidgetCell ， 它 允许 一 个 任意 

的 wxPython 控件 像 任何 其 它 单元 一 样 被 插入 到 一 个 HTML 文档 中 。 除 了 可 以 包 
括 用 于 格式 化 显示 的 静态 文本 ， 这 也 包括 任何 类 型 的 用 于 管理 HTML 表单 的 控 
件 。 wx. html.HtmlWidgetCell 的 构造 函数 如 下 : 


wx.html.HtmlwidgetCell(wnd, w=0) 


其 中 参数 wd 是 要 被 绘制 的 wxPython 控件 。 参 数 W 是 一 个 浮动 宽度 。 如 果 W 不 
为 0， 那 么 它 应 该 是 介 于 1 和 100 之 间 的 一 个 整数 ，wnd 控件 的 宽度 则 被 动态 地 调 
整 为 相对 于 其 父 容器 宽度 的 Ww%。 


另外 还 有 其 它 许 多 类 型 的 用 于 显示 HTML 文档 的 部 分 的 单元 。 更 多 的 信息 请 参 
A wxWidget 文档 。 


如 何 增加 对 新 标记 的 支持 ? 


被 解析 器 返回 的 单元 是 被 标记 处 理 器 内 在 的 创建 的 ， 通 过 HTML 标记 ， 一 个 可 插入 
的 结构 与 HTML 解析 器 单元 的 创建 和 处 理 相 联 系 起 来 。 你 可 以 创建 你 自己 的 标记 处 
理 器 ， 并 将 它 与 HTML 标记 相关 联 。 使 用 这 个 机 制 ， 你 可 以 扩展 HTML 窗口 ， 以 
包括 当前 不 支持 的 标准 标记 ， 或 你 自己 发 明 的 自 定 义 的 标记 。 图 16.4 显 示 了 自 定 
义 HTML 标记 的 用 法 。 


图 16.4 


Custom HTML Tag Handler 


This silly example shows how custom tags can be defined 
and used in a wx.HtmlWindow. We've defined a new tag, 
| «blue» that will change the foreground color of the 
portions of the document that it encloses to some shade of 
blue. The tag handler can also use parameters specifed in 
| the tag, for example 


@ Sky Blue 

* Midnight Blue 

* Dark Blue 

* Navy Blue 

Figure 16.4 

A wx.HtmIWindow using 
a custom tag handler 





下 例 16.4 是 产生 图 16.4 的 代码 。 
例 16.4 定义 并 使 用 自 定 义 的 标记 处 理 器 


import wx 
import wx.html 


page = """ html body 


This silly example shows how custom tags can be defined and used 
ina 

wx.HtmlWindow. We've defined a new tag, blue that will change 
the blue foreground color /blue of the portions of the documen 
t that 

it encloses to some shade of blue. The tag handler can also use 
parameters specifed in the tag, for example: 


ul 

li blue shade='sky' Sky Blue /blue 

Ji: blue shade='midnight' Midnight Blue /blue 
li blue shade='dark' Dark Blue /blue 

li blue shade='navy' Navy Blue /blue 

/ul 


/body /html 


class BlueTagHandler (wx. html.HtmlWinTagHandler ) : 4/5 9] s i5 4: 2 25 
def _ init (self): 
wx.html.HtmlwinTagHandler. init__(self) 


def GetSupportedTags(self) :# 定 义 要 处 理 的 标记 
return "BLUE" 


def HandleTag(self, tag) :# 处 理 标 记 
old = self.GetParser().GetActualColor() 
clr = "#0000FF" 
if tag.HasParam(" SHADE"): 
shade = tag.GetParam( SHADE") 


if shade.upper() == "SKY": 
clr = "#3299CC" 

if shade.upper() == "MIDNIGHT": 
clr = "#2F2F4F" 

elif shade.upper() == "DARK": 
clr = "#00008B" 

elif shade.upper == "NAVY": 


clr = "#23238E" 


self .GetParser().SetActualColor(clr) 
self .GetParser().GetContainer().InsertCell(wx.html.Htm1c 
olourCell(clr)) 


self.ParseInner(tag) 


self.GetParser().SetActualColor(old) 
self.GetParser().GetContainer().InsertCell(wx.html.HtmlC 
olourCell(old)) 


return True 
wx.html.HtmlWinParser AddTagHandler(BlueTagHandler ) 


class MyHtmlFrame(wx.Frame): 
def — init (self, parent, title): 
wx.Frame. (init (self, parent, -1, title) 
html = wx.html.Htmlwindow(self) 
if "gtk2" in wx.PlatformInfo: 
html.SetStandardFonts() 
html.SetPage(page) 


app - wx.PySimpleApp() 

frm = MyHtmlFrame(None, "Custom HTML Tag Handler") 
frm.Show() 

app.MainLoop() 


标记 内 在 的 由 类 wx.Html.Tag 的 方法 来 表现 ， 标 记 的 实例 由 HTML 解析 器 来 创 
建 ， 通 常 ， 你 不 需要 自己 创建 。 表 16.4 显 示 了 wx.Html.Tag 类 的 方法 ， 它 们 有 用 
于 检索 标记 的 信息 2 


#16.4 wx.Html.Tag 的 一 些 方法 


返回 与 标记 相关 的 所 有 参数 ， 返 回 
值 是 一 个 字符 串 。 出 于 某 些 目的 ， 


SEARE 解析 字符 串 比 得 到 各 个 单独 的 参数 


SEENEN 以 大 写 的 方式 ， 返 回 标记 的 名 字 。 
RICA ET KR m3 
HasParam(param) ho RAR ICH T HK? MYR 
€ True ° 


返回 参数 param 的 值 。 如 果 参 数 
with commas A True ， 那 么 
你 得 到 一 个 首尾 都 有 引号 的 原始 字 
AO o eR AUR dE Ao RA 
GetParam(param, with commas-False) 返回 一 个 空 字符 串 。 方 

法 GetParamAsColour(param) Z 
回 的 参数 值 是 一 个 wx.Color ? Z 
法 GetParamAsInt(param) 返回 
整数 值 。 


如 果 标 记 有 结束 标记 的 话 ， 返 
HasEnd > 

EERO 回 True » GUAE false ° 
用 于 扩展 HTML 窗口 的 标记 处 理 器 都 是 wx.html.HtmlwinTagHandler 的 子 类 。 
你 的 子 类 需要 履 盖 两 个 方法 ， 并 且 你 需要 知道 进一步 的 方法 。 需 要 履 盖 的 第 一 个 方 
法 是 GetSupportedTags() 。 该 方法 返回 由 处 理 器 管理 的 标记 的 列表 。 标 记 必需 
是 大 写 的 ， 并 且 标 记 之 间 以 去 号 分 隔 ， 中 间 不 能 有 空格 ， 如 下 所 示 : 


GetSupportedTags(self): 
return "MYTAG, MYTAGPARAM" 


第 二 个 你 需要 和 履 盖 的 方法 是 HandleTag(tag) ° Æ HandleTag(tag) 方法 中 ， 你 
通过 增加 新 的 单元 元 素 到 解析 器 来 处 理 标 记 (或 者 交替 地 改变 解析 器 已 经 打开 的 容 
器 单元 ) 。 你 可 以 通过 调用 标记 处 理 器 的 GetParser() 方法 来 得 到 解析 器 。 


要 写 一 个 HandleTag(tag) 方法 ， 你 应 该 像 下 面 这 样 做 : 


1、 得 到 解析 器 。2、 对 你 的 标记 的 参数 做 必要 的 处 理 ， 可 能 要 改变 或 创建 一 个 新 的 
单元 。 3、 如 果 被 解析 的 标记 包括 着 内 在 的 文本 ， 那 么 解析 标记 之 间 的 文本 。 4、 
执行 对 于 解析 器 所 需要 的 任何 清理 工作 。 


如 上 所 述 ， 你 使 用 GetParser() 方法 得 解析 器 。 要 添加 或 编辑 解析 器 中 的 单元 ， 

你 有 三 个 可 选 方案 。 第 一 个 ， 如 果 你 想 添加 另 一 个 单元 到 容器 中 ， 你 可 以 工作 于 当 
前 的 容器 。 第 二 个 ， 你 可 以 调用 解析 器 的 Container() 方法 ， 然 后 创建 你 

的 wx.html.HTMLCell 子 类 实例 ， 并 通过 调用 容器 的 InsertCell(cell) 方法 将 
它 添加 到 容器 。 


AR o RT SERRE 3S ATJT 3 SP LE — TRES 0 RIRE o HARTER 
的 一 行 中 的 一 个 单元 格 。 要 实现 这 个 ， 你 需要 调用 解析 器 的 Opencontainer() 方 
法 。 这 个 方法 返回 你 的 新 的 容器 单元 ， 你 可 以 使 用 InsertCell(cell) 方法 来 播 
eer es RAT ET 7 betta 中 打开 的 容器 ， 你 
应 该 使 用 CloseContainer() 方法 来 关闭 它 果 你 没有 成 对 的 使 

用 Opencontainer() 和 CloseContainer() ， pny eee km eU 

的 HTML 文本 时 出 现 混乱 。 


第 三 个 方案 是 创建 一 个 与 解析 器 的 当前 容器 同 级 的 容器 ， 意 思 是 不 是 艇 入 的 。 例 如 
一 个 新 的 段落 它 不 是 前 一 段 的 一 部 分 ， 也 不 附属 于 前 一 段 ; 它 是 该 页 中 ?党 桓 
$5 Ek SE sae NIER M ES DE 98 ZB dc 338 E BY AP AR Je AH US AE AB (RIE 4 953 
Jp AE 8 3e 29 PR oH] ? 





parser = self.GetParser() 
parser.CloseContainer ()4 X H] 3L i RSE 
parser.OpenContainer( )# 打 一 个 新 的 容器 


# 添加 或 编辑 解析 器 中 的 单元 


parser.CloseContainer() 
parser.OpenContainer() 


如 何 支 持 其 他 的 文件 格式 ? 


默认 情况 下 ， HTML 窗口 可 以 处 理 带 有 MIME 类 

型 text / html, text / txt， 和 image /* (假设 wxPython 图 像 处 理 器 已 经 被 
RR) 的 文件 。 当 碰 上 一 个 不 是 图 像 或 HTML 文件 的 文件 时 ， 该 HTML 窗口 试图 
dodo E 这 可 以 不 是 你 想 要 的 行为 。 如 果 有 一 些 文件 你 想 以 自 定义 
的 方式 显示 它 的 话 ， 你 可 以 创建 一 个 wx.html.HtmlFilter 来 处 理 它 。 比 如， 你 
可 能 想 以 涛 代码 树 的 方式 显示 XML 文件 ， 或 使 用 语法 着 色 来 显示 Python RAG 
文件 。 


要 创建 一 个 利 选 器 ( filter ) ， 你 必须 建造 wx.,html.HtmlFilter 的 一 个 子 
类 。 wx.html.HtmlFilter 类 有 两 个 方法 ， 你 必须 都 覆盖 它们 。 这 第 一 个 方法 

是 CanRead(file) 。 a file 是 wx.FSFile (一 个 打开 的 文件 

的 wxPython 表示 ) 的 一 个 实例 。 类 wx.FSFile 有 两 个 属性 ， 你 可 以 用 来 决定 你 
的 筛选 器 wr e. 方法 GetMimeType() 以 一 个 字符 串 的 形式 返回 该 文 
件 的 MIME 类 型 。 MIME 类 型 通常 由 文件 的 后 组 所 定义 。 方 法 GetLocation() & 
回 带 有 相关 文件 位 置 的 绝对 路 径 或 URL 的 一 个 字符 串 。 如 果 算 选 器 会 处 理 该 文件 
的 话 ， CanRead() 方法 应 该 返回 True > GIAE False 。 处 理 Python RX 
件 的 CanRead() 的 一 个 示例 如 下 


CanRead(self, file): 
return file.GetLocation().endswith('.py') 


第 二 个 你 需要 覆盖 的 方法 是 ReadFile(file) 。 这 个 方法 要 求 一 个 同样 

的 file 参数 ， 并 返回 该 文件 内 容 的 一 个 字符 串 的 HTML 表达 。 如 果 你 不 想 使 
用 wxwidgets C ++ 的 文件 机 制 来 读 该 文件 的 话 ， 你 可 以 通过 简 单 地 打开 位 
于 file.GetLocation() 的 文件 来 使 用 Python 的 文件 机 制 。 


一 旦 筛选 器 被 创建 了 ， 那 么 它 必须 被 注册 到 wx.html.Htmlwindow ， 使 

用 wx.html.Htmlwindow 窗口 的 AddFilter(filter) 静态 方法 来 实现 。 参 
数 ud a 的 新 的 wx. D HtmlFilter 类 的 一 个 实例 。 一 旦 注册 了 算 选 
器 ， 那 么 该 窗口 就 可 以 使 用 筛选 器 来 管理 通过 了 CanRead() 测试 的 文件 对 象 。 


如 何 得 到 一 个 性 能 更 加 完整 的 HTML 控 件 ? 

尽管 wx.html.Htmlwindow 不 是 一 个 完整 特性 的 浏览 器 面板 ， 但 是 这 儿 有 一 对 用 
FA E JjecsoÓ TEES) HTML 表现 窗口 的 选择 。 如 果 你 是 在 Windows 平台 上 ， 你 
可 以 使 用 类 wx.1ib.iewin.IEHtmlWindow ， 

是 Internet Explorer ActiveX 控件 的 封装 。 这 使 得 你 能 够 直接 将 ie ud 
入 到 你 的 应 用 程序 中 。 


使 用 IE 控件 比较 简单 ， 类 似 于 使 用 内 部 的 wxPython 的 HTML 窗口 。 它 的 构造 
HEAT : 


wx.lib.iewin.IEHtmlWindow(self, parent, ID=-1, 
pos-wx.DefaultPosition, size-wx.DefaultSize, style-0, 
name-'IEHtmlWindow!') 


其 中 参数 parent 是 父 窗口 ， ID Æ wxPython ID 。 对 于 IE 窗口 ， 这 儿 没 有 
可 用 的 样式 标记 。 要 装载 HTML 到 IE 组 件 中 ， 可 以 使 用 方 

法 LoadString(html) ， 其 中 参数 html 是 要 显示 的 一 个 HTML 字符 串 。 你 可 以 
使 用 方法 LoadStream(stream) 装载 自 一 个 打开 的 文件 ， 或 一 个 Python 文件 对 
象 ; 或 使 用 Loadstring(URL) 方法 装载 自 一 个 URL 。 你 能 够 使 

用 GetText(asHTML) 来 获取 当前 显示 的 文本 。 参 数 asHTML 是 布尔 值 。 如 果 

为 True ， 则 返回 HTML 形式 的 文本 ， 否 则 仅 返 回 一 个 文本 字符 串 。 


在 其 它 平台 上 ， 你 可 以 尝试 一 下 wxMozilla 项 目 

( http: // wxmozilla.sourceforge.net) ， 该 项 目 尝试 创建 一 

个 Mozilla Gecko 表现 器 的 wxPython 封装 。 目 前 该 项 目 仍 在 测试 阶 

段 。 wxMozilla 有 用 于 windows 和 Linux 的 安装 包 ， 对 Mac OS X 的 支持 正 
在 开发 中 。 


本 章 小 结 


1^ HTML 不 再 是 只 用 于 Internet 了 。 在 wxPython 中 ， 你 可 以 使 用 一 

个 HTML. 窗口 来 显示 带 有 HTML 标记 的 简单 子 集 的 文本 。 该 HTML 窗口 属 

于 wx.html.Htmlwindow 类 。 除 了 HTML 文本 ， 该 HTML 窗口 还 可 以 管理 任 一 的 
Ak (图 像 处 理 器 已 装载 的 情况 下 ) ° 


2、 你 可 以 让 HTML 窗口 显示 一 个 字符 串 ， 一 个 本 地 文件 或 一 个 URL 的 信息 。 你 
可 以 像 通 常 的 超 文本 浏览 器 的 方式 显示 用 户 的 敲 击 ， 或 使 用 它 自 定义 的 响应 。 你 也 
可 以 将 HTML 窗口 与 它 的 框架 相连 接 起 来 ， 以 便 标题 和 状态 信息 自动 地 显示 在 适当 
的 地 方 。 HTML 窗口 维护 着 一 个 历史 列表 ， 你 可 以 对 它 进 行 访问 和 处 理 。 你 可 以 使 
用 类 wx.Html.HtmlEasyPrinting 来 直接 打印 你 的 页 面 。 


3、 在 wxPython 中 有 一 个 HTML 解析 器 ， 你 可 以 用 来 创建 用 于 你 自己 窗口 的 自 定 
义 标 记 。 你 也 可 以 配置 自 定义 的 文件 筛选 器 来 在 一 个 HTML 窗口 中 表现 其 它 的 文件 
格式 。 


4、 最 后 ， 如 果 你 对 HTML 窗口 的 局 限 性 不 太 满意 的 话 ， 那 么 你 可 以 使 用 一 个 
对 IE 控件 的 wxPython 封闭 。 如 果 你 不 在 Windows 上 的 话 ， 这 儿 也 有 一 个 
对 Mozilla Gecko HTML 表现 器 的 wxPython 的 封装 。 


第 十 七 章 wxPython 的 打印 构架 


本 章 内 容 
e 用 wxPython 打印 
e 创建 和 显示 打印 对 话 杠 


e 创建 和 显示 页 面 设置 对 话 框 
。 在 你 的 程序 中 执行 打印 
。 执行 一 个 打印 预览 


在 第 16 章 中 ， 我 们 已 经 关注 了 wxPython 的 一 打印 方法 : 使 

用 wx.HtmlEasyPrinting 。 如 果 你 用 该 方法 打印 HTML (或 菜 些 容易 转换 

为 HTML 的 文件 ) 的 话 ， 这 个 方法 将 会 工作 的 很 好 ， 但 是 要 作为 一 个 完善 打印 办 法 
还 是 不 够 的 。 在 wxPython 中 还 有 一 个 更 为 通用 的 打印 构架 ， 你 可 以 用 它 来 打印 你 
想 打 印 的 任何 东西 。 基 本 上 ， 该 构架 使 你 能 够 使 用 设备 上 下 文 和 绘制 操作 来 执行 打 
印 。 你 也 可 以 创建 打印 预览 。 


本 章 将 讨论 该 构架 中 最 重要 的 类 : wx.Printout ， 它 管理 实际 的 图 片 部 分 。 打 印 
输出 实例 可 以 由 一 个 代表 打印 机 的 wx.Printer 对 象 或 用 于 打印 预览 

的 wx.PrintPreview 对 象 来 管理 。 多 们 也 将 讨论 几 个 管理 与 打印 相关 的 数据 的 
类 ， 以 及 用 来 显示 信息 给 用 户 的 对 话 框 。 


如 何 用 wxPython 打 印 ? 


我 们 将 以 类 wx.Printout 作为 开始 。 首 先 你 要 创建 你 自 定义 的 wx.Printout 的 
FX dE REX wx.Printout 的 方法 以 定义 你 自 定 义 的 打印 行 

为 。 wx.Printout 有 7 个 你 可 以 覆盖 以 自 定义 打印 行为 的 方法 。 这 些 方法 在 一 个 

打印 会 话 过 程 期 间 被 wxPython 自动 调用 。 图 17.1 其 中 的 六 个 方法 ， 它 们 被 特定 的 
事件 触发 。 在 大 多 数 情况 下 ， 你 不 需要 全 部 覆盖 它们 。 


图 17.1 
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Figure 17.1 The lifecycle of a printout showing all the methods automatically 
called by wxPython 


理解 打印 输出 的 生命 周期 


你 通过 创建 一 个 你 的 打印 输出 对 象 的 实例 和 一 个 类 wx.Printer 的 实例 启动 一 个 
打印 会 话 : 


wx.Printer(data-None) 


可 选 的 data 44 wx.PrintDialogData 的 一 个 实例 。 要 开始 实际 的 打印 ， 需 
要 调用 wx.Printer 的 Print(parent, printout, prompt-True) 方法 。 参 
数 parent 是 父 窗口 〈 它 被 用 作对 话 框 的 窗口 中 ) 。 参 数 printout 是 你 

的 wx.Printout 实例 。 如 果 参 数 prompt 为 True ， 那 么 在 打印 之 

前 ， wxPython 将 显示 打印 对 话 框 ， 否 则 不 显示 。 


在 Print() 方法 开始 后 ， 它 调用 wx.Printout 的 第 一 个 可 被 覆盖 的 方 
法 OnPreparePrint() 。 OnPreparePrint() 方法 在 wx.Printout 实例 做 任何 
其 它 的 事 之 前 被 确保 调用 ， 因 此 该 方法 是 放置 收集 你 的 数据 或 做 那些 必须 在 打印 开 
始 之 前 所 要 做 的 计算 的 一 个 好 的 地 方 。 实 际 的 打印 使 用 OnBeginPrinting() 方法 
开始 ， 你 可 以 对 该 方法 进行 履 盖 ， 以 自 定 主 你 想 要 的 行为 默认 情况 下 ， 该 方法 
什么 也 不 做 。 OnBeginPrinting() 在 整个 打印 会 话 中 只 会 被 调用 一 次 。 


你 希望 打印 的 文档 的 每 个 单独 的 拷贝 触发 

对 OnBeginDocument(startPage, endPage) 的 一 个 调用 ， 其 中 参 

数 startPage, endPage 告诉 wxPython 打印 的 起 始 页 和 最 后 一 页 。 这 两 个 参数 
都 应 该 指定 。 如 果 你 想 履 盖 这 个 方法 ， 那 么 你 必须 调用 它 的 基 类 的 方法 ， 因 为 基 类 
的 方法 要 做 一 些 重要 的 工作 (如 调用 wx.DC.StartDoc() ) ° Æ wxPython 中 ， 
你 可 以 使 用 base OnBeginDocument(startPage, endPage) 来 调用 其 父 类 的 方 
法 。 如 果 OnBeginDocument 返回 False ， 那 么 将 取消 打印 工作 。 





RA TEAR 3:900 AA OnPrintPage(pageNum) ， 该 方法 是 你 放置 关于 每 一 
页 的 绘制 命令 的 地 方 。 参 数 pageNum 是 要 打印 的 页 的 页 码 。 在 这 个 方法 中 ， 你 调 
用 GetDC() > GetDC() 根据 你 当前 的 系统 平台 返回 一 个 适当 的 设备 上 下 文 。 对 

于 实际 的 打印 ， 如 果 你 是 在 一 个 微软 的 Windows 系统 上 的 话 ， 那 么 GetDC() 返 

回 的 是 类 wx.PrinterDC 的 实例 。 对 于 其 它 的 系统 ， 返 回 的 是 

类 wx.PostScriptDC 的 实例 。 如 果 你 是 处 在 一 个 打印 预览 操作 中 ， 那 么 对 于 任何 
的 操作 系统 ， GetDC() 返回 的 都 是 一 个 wx.MemoryDC 。 一 旦 你 有 了 设备 上 下 

文 ， 你 就 可 以 做 你 想 做 的 设备 上 下 文 绘制 操作 ， 并 且 它 们 将 被 打印 或 预览 。 


在 一 个 文档 的 副本 打印 结束 后 ， 一 个 OnEndDocument() 调用 被 触发 。 另 外 ， 如 果 
ZR Š OnEndDocument() 方法 ， 那 么 你 必须 调用 其 基 类 的 方 

法 base_OnEndDocument() 。 base_OnEndDocument() 将 调 

用 wx.DC.EndDoc() 方法 。 当 你 的 所 有 的 副本 被 打印 完 

后 ， OnEndPrinting() 方法 被 调用 ， 这 样 就 结束 了 打印 会 话 。 


wx.Printout 还 有 另 一 个 可 被 覆盖 的 方法 : HasPage(pageNum) 。 该 方法 通常 
需要 被 覆盖 ， 它 被 打印 架构 用 于 循环 控制 。 如 果 参 数 pageNum FET ULB FH > Ap 
么 该 方法 返回 True > GIAE False 。 


实战 打印 构架 


下 面 我 们 将 通过 一 个 例子 来 展示 打印 构架 实际 上 是 如 何 工作 的 。 这 个 例子 由 一 个 简 
单 的 用 于 打印 文本 文件 的 构架 组 成 ， 并 且 应 用 程序 让 你 能 够 键入 简单 的 文本 。 图 
17.2 显 示 了 这 个 应 用 程序 的 结果 。 


图 17.1 


一 -一 
BE Print Framework Sample CER) 
Fie 

Far BROTHERS GRIMM 

FAIRY TALES 


THE GOLDEN BIRD 


A certain king had a beautiful garden, and in the garden stood a tree 
which bore golden apples. These apples were always counted, and about 
the time when they began to grow ripe ít was found that every night 
one of them was gone. The king became very angry at this, and ordered 
the gardener to keep watch all night under the tree. The gardener set 
his eldest son to watch; bur about twelve o'clock he fell asleep, and 
in the morning another of the apples was missing. Then the second son 
was ordered to watch: and at midnight he too fell asleep, and in the 
morning another apple was gone. Then the third gon offered to keep 
watch: but the gardener at first would not let him, for fear some harm 
should come to him: however, at last he consented, and She young man 
laid himself under the tree to watch. As the clock struck twelve he 
heard a rustling noise in the sir, and a bird came flying that was of 
pure gold; and as it was snapping at one of the apples with its beak, 
the gardenerz's son jumped up and shot an arrow at it. But the arrow 


did the bird no harm; only it dropped a golden feather from its tail, 





Figure 17.2 The simple printing framework in action 
例 17.1 显 示 了 我 们 已 经 讨论 过 的 打印 构架 和 我 们 将 要 接触 的 打印 对 话 框 机 制 。 
例 17.1 打印 构架 的 一 个 较 长 的 例子 


import wx 
import os 


FONTSIZE 


= 10 


class TextDocPrintout(wx.Printout): 


A printout class that is able to print simple text documents. 
Does not handle page numbers o titles, and it assumes that no 
lines are longer than what will fit within the page width. Tho 


se 


features are left as an exercise for the reader. ;-) 


hen 


If 


we 


the 


def 


def 


def 


def 


— init__(self, text, title, margins): 
wx.Printout. init__(self, title) 
self.lines = text.split('\n') 
self.margins = margins 


HasPage(self, page): 
return page = self.numPages 


GetPageInfo(self): 
return (1, self.numPages, 1, self.numPages) 


CalculateScale(self, dc): 
# Scale the DC such that the printout is roughly the sam 


# the screen scaling. 

ppiPrinterX, ppiPrinterY - self.GetPPIPrinter() 
ppiScreenX, ppiScreenY - self.GetPPIScreen() 
logScale - float(ppiPrinterX)/float(ppiScreenX) 


4 Now adjust if the real page size is reduced (such as w 
# drawing on a scaled wx.MemoryDC in the Print Preview.) 
# page width == DC width then nothing changes, otherwise 
# scale down for the DC. 

pw, ph self.GetPageSizePixels() 


dw, dh dc.GetSize() 
scale - logScale * float(dw)/float(pw) 


# Set the DC's scale. 
dc.SetUserScale(scale, scale) 


# Find the logical units per millimeter (for calculating 


# margins) 
self.logUnitsMM = float(ppiPrinterX)/(logScale*25.4) 


def CalculateLayout(self, dc): 


# Determine the position of the margins and the 

# page/line height 

topLeft, bottomRight = self.margins 

dw, dh = dc.GetSize() 

self.x1 = topLeft.x * self.logUnitsMM 

self.y1 - topLeft.y * self.logUnitsMM 
self.x2 - dc.DeviceToLogicalXRel(dw) - bottomRight.x * self.logU 
nitsMM 
self.y2 - dc.DeviceToLogicalYRel(dh) - bottomRight.y * self.logU 
nitsMM 


# use a imm buffer around the inside of the box, and a f 


ew 
# pixels between each line 
self.pageHeight = self.y2 - self.y1 - 2*self.logUnitsMM 
font = wx.Font(FONTSIZE, wx.TELETYPE, wx.NORMAL, wx.NORM 
AL) 


dc.SetFont(font) 
self.lineHeight - dc.GetCharHeight() 
self.linesPerPage - int(self.pageHeight/self.lineHeight) 


def OnPreparePrinting(self): 
# calculate the number of pages 
dc = self.GetDC() 
self.CalculateScale(dc) 
self.CalculateLayout(dc) 
self.numPages - len(self.lines) / self.linesPerPage 
if len(self.lines) % self.linesPerPage != 0: 
self.numPages += 1 


def OnPrintPage(self, page): 
dc = self .GetDC() 
self .CalculateScale(dc) 
self .CalculateLayout (dc) 


# draw a page outline at the margin points 

dc.SetPen(wx.Pen("black", 0)) 

dc.SetBrush(wx.TRANSPARENT BRUSH) 

r - wx.RectPP((self.x1, self.y1), 
(self.x2, self.y2)) 

dc.DrawRectangleRect(r) 

dc.SetClippingRect(r) 


4 Draw the text lines for this page 
line - (page-1) * self.linesPerPage 
X = self.x1 + self.logUnitsMM 
y = self.y1 + self.logUnitsMM 
while line (page * self.linesPerPage): 
dc.DrawText(self.lines[line], x, y) 
y *- self.lineHeight 
line += 1 
if line = len(self.lines): 
break 


return True 


class PrintFrameworkSample(wx.Frame) : 


AP) 


def 


. init (self): 

wx.Frame. init (self, None, size=(640, 480), 
title-"Print Framework Sample") 

self.CreateStatusBar() 


# A text widget to display the doc and let it be edited 
self.tc - wx.TextCtrl(self, -1, "", 
style-wx.TE MULTILINE]|wx.TE DONTWR 


self.tc.SetFont(wx.Font(FONTSIZE, wx.TELETYPE, wx.NORMAL 


, WX.NORMAL) ) 


le-text. 


nt") 


def 


def 


filename = os.path.join(os.path.dirname(__file__), "samp 
txt") 

self.tc.SetValue(open( filename) .read() ) 
self.tc.Bind(wx.EVT SET FOCUS, self .OnClearSelection) 
wx.CallAfter(self.tc.SetInsertionPoint, 0) 


4 Create the menu and menubar 
menu = wx.Menu() 
item = menu.Append(-1, "Page Setup... NtF5", 

"Set up page margins and etc.") 
self.Bind(wx.EVT MENU, self.OnPageSetup, item) 
item = menu.Append(-1, "Print Setup...NtF6", 

"Set up the printer options, etc.") 
self.Bind(wx.EVT MENU, self.OnPrintSetup, item) 
item = menu.Append(-1, "Print Preview...\tF7", 

"View the printout on-screen") 
self.Bind(wx.EVT MENU, self.OnPrintPreview, item) 
item - menu.Append(-1, "Print...NtF8", "Print the docume 


self.Bind(wx.EVT MENU, self.OnPrint, item) 
menu.AppendSeparator() 

item - menu.Append(-1, "E ", "Close this application") 
self.Bind(wx.EVT MENU, self.OnExit, item) 


menubar = wx.MenuBar() 
menubar.Append(menu, " ") 
self .SetMenuBar (menubar) 


# initialize the print data and set some default values 
self.pdata = wx.PrintData() 
self.pdata.SetPaperId(wx.PAPER LETTER) 
self.pdata.SetOrientation(wx.PORTRAIT) 

self.margins - (wx.Point(15,15), wx.Point(15,15)) 


OnExit(self, evt): 
self.Close() 


OnClearSelection(self, evt): 
evt.Skip() 


wx.CallAfter(self.tc.SetInsertionPoint, 
self.tc.GetInsertionPoint()) 


def OnPageSetup(self, evt): 
data = wx.PageSetupDialogData() 
data.SetPrintData(self.pdata) 


data.SetDefaultMinMargins(True) 
data.SetMarginTopLeft(self.margins[0]) 
data.SetMarginBottomRight(self.margins[1]) 


dlg - wx.PageSetupDialog(self, data) 
if dlg.ShowModal() == wx.ID OK: 
data = dlg.GetPageSetupData() 
self.pdata = wx.PrintData(data.GetPrintData()) # for 
ce a copy 
self .pdata.SetPaperId(data.GetPaperId() ) 
self.margins = (data.GetMarginTopLeft(), 
data.GetMarginBottomRight()) 
dlg.Destroy() 


def OnPrintSetup(self, evt): 
data - wx.PrintDialogData(self.pdata) 
dlg - wx.PrintDialog(self, data) 
dlg.GetPrintDialogData().SetSetupDialog(True) 
dlg.ShowModal(); 
data = dlg.GetPrintDialogData() 
self.pdata = wx.PrintData(data.GetPrintData()) # force a 


copy 
dlg.Destroy() 


def OnPrintPreview(self, evt): 
data - wx.PrintDialogData(self.pdata) 
text - self.tc.GetValue() 
printouti = TextDocPrintout(text, "title", self.margins) 
printout2 = None #TextDocPrintout(text, "title", self.ma 


rgins) 
preview = wx.PrintPreview(printouti, printout2, data) 
if not preview.Ok(): 
wx.MessageBox("Unable to create PrintPreview!", "Err 
or") 
else: 
# create the preview frame such that it overlays the 
app frame 
frame - wx.PreviewFrame(preview, self, "Print Previe 
w", 


pos=self.GetPosition(), 
size-self.GetSize()) 
frame.Initialize() 
frame.Show() 


def OnPrint(self, evt): 
data - wx.PrintDialogData(self.pdata) 


printer = wx.Printer(data) 
text = self.tc.GetValue() 
printout = TextDocPrintout(text, "title", self.margins) 
useSetupDialog = True 
if not printer.Print(self, printout, useSetupDialog) \ 
and printer.GetLastError() == wx.PRINTER_ERROR: 
wx .MessageBox ( 
"There was a problem printing. \n" 
"Perhaps your current printer is not set correct 


ly?", 
"Printing Error", wx.OK) 
else: 
data - printer.GetPrintDialogData() 
self.pdata - wx.PrintData(data.GetPrintData()) £ for 
ce a copy 


printout.Destroy() 


app - wx.PySimpleApp() 

frm = PrintFrameworkSample() 
frm.Show( ) 

app .MainLoop( ) 


例 17.2 中 的 打印 输出 类 能 够 打印 简单 的 文本 文档 ， 但 是 不 能 处 理 页 码 或 标题 ， 并 且 
它 创 假设 了 行 的 宽度 没有 超过 页 面 的 宽度 。 对 于 例子 的 完善 就 留 给 读者 作为 一 个 练 
J o 

上 面 最 重要 的 代码 片断 是 在 构架 的 OnPreparePrinting() 和 OnPrintPage() 以 
及 示例 窗口 的 OnPrint() 方法 中 。 


使 用 wx.Printout 的 方法 工作 


在 wx.Printout 中 有 几 个 get * 方 法 ， 它 们 使 你 能 够 获取 当前 打印 环境 的 有 关 信 
息 。 表 17.1 列 出 了 这 些 方 法 。 


表 17.1 wx.Printout 的 信息 获取 方法 


GetDC( ) 


GetPageInfo() 


GetPageSizeMM() 


GetPageSizePixels() 


GetPPIPrinter() 


GetPPIScreen() 


GetTitle() 


该 方法 返回 关于 打印 机 或 打印 预览 的 用 于 绘制 文档 的 


iK el — 4878 01 7G 83 7628 

( minPage, maxPage, pageFrom, pageTo) ° mir 
Bl x Pf fo TE RS eb fe ALES > ERES 

32000 ° pageFrom, pageTo 是 必须 被 打印 的 范围 ， 
EMUNFRPR ERA © 


返回 包含 一 个 页 面 的 宽度 和 高 度 的 一 个 ( w, h) 元 组 


返回 一 个 页 面 的 宽度 和 高 度 的 一 个 ( w，h) 元 组 ， 以 
打印 输出 被 用 于 打印 预览 ， 那 么 像素 数 将 反应 当前 的 
是 说 像素 将 会 随 缩放 上 比 列 而 变 。 


返回 当前 打印 机 在 得 直 和 水 平方 向 上 每 英寸 的 像素 的 
组 。 在 预览 中 ， 这 个 值 也 是 始终 一 致 的 ， 即 使 打印 预 
了 o 


返回 当 HY it aR Ae E 直 和 水 平方 向 上 每 英寸 的 像素 的 一 
在 预览 中 ， 这 个 值 也 是 始终 一 致 的 ， 即 使 打印 预览 的 


返回 打印 输出 的 标题 。 


在 后 面 的 几 节 中 ， 我 们 将 讨论 如 何 呈 现 打 印 对 话 框 给 用 户 。 


如 何 显示 打印 对 话 框 ? 


诸如 要 打印 那些 面 面 ， 要 打印 多 少 副本 这 些 关于 打印 工作 的 数据 是 由 标准 的 打印 对 
话 框 来 管理 的 。 打 印 对 话 框 是 与 字体 和 颜色 对 话 框 类 似 的 ， wxPython 中 的 打印 对 
话 框 实例 仅仅 是 对 本 地 控件 和 一 个 储存 了 对 话 框 数据 的 分 离 的 数据 对 象 的 简单 封 


装 。 


创建 一 个 打印 对 话 框 


图 17.3 显 示 了 打印 设置 对 话 框 的 样 例 。 


图 17.3 


Print Setup 


Network K c Figure 17.3 


The print setup dialog 





这 里 的 对 话 框 是 类 wx.PrintDialog AE H] > T VASE RIT do 0 39 3&8 RAR 
得 到 : 


wx.PrintDialog(parent, data=None) 


HYP > SH parent 是 对 话 框 的 父 框 架 ， 参 数 data 是 一 个 预先 存在 
的 wx.PrintDialogData 实例 ， 它 用 于 对 话 框 的 初始 数据 。 


使 用 方法 


一 旦 你 有 了 打印 对 话 框 ， 你 就 可 以 使 用 标准 的 ShowModal() 方法 来 显示 

它 ， ShowModal() 方法 将 根据 用 户 关闭 对 话 框 的 方式 而 返 

回 wx.ID OK X wx.ID CANCEL 。 在 你 关闭 了 对 话 框 之 后 ， 你 可 以 使 

用 GetPrintDialogData() 方法 来 得 到 用 户 输入 的 数据 。 你 也 可 以 使 

用 GetPrintDC() 方法 得 到 与 数据 相关 联 的 打印 机 的 设备 上 下 文 ， 如 果 还 没有 内 
容 被 创建 ， 那 么 GetPrintDC() 方法 返回 None 。 例 17.1 中 

的 OnPrintSetup() 方法 显示 了 实际 上 对 话 框 是 如 何 被 获取 的 。 


使 用 属性 


这 个 数据 对 象 本 身 有 几 个 属性 ， 其 中 的 一 个 是 对 wx.PrintData 类 型 的 一 个 对 象 
的 引用 ， wx.PrintData 有 更 多 的 属性 。 你 可 以 使 用 构造 隐 
数 wx.PrintDialogData() 来 创建 你 的 wx.PrintDialogData 对 象 。 这 使 得 你 能 
够 在 打开 对 话 框 之 前 预 设 属性 。 
wx.PrintDialogData 对 象 有 四 个 属性 用 于 控制 打印 对 话 框 的 各 个 部 分 的 有 效 
性 。 方 法 EnableHelp(enable) 用 于 开关 帮助 性 能 。 至 于 对 话 框 的 其 它 部 
分 ， EnablePageNumbers(enable) 与 页 面 数 量 输 入 框 相 
关 ， EnablePrintToFile(enable) 管理 实际 的 打印 按 
41* EnableSelection(enable) 在 打印 所 有 和 仅 打 印 被 选项 之 间作 切换 。 
表 17.2 显 示 了 对 话 框 数据 对 象 的 其 它 属性 ， 它 们 使 你 能 够 管理 有 关 打 印 请 求 的 信 


表 17.2 wx.PrintDialogData 的 属性 


ES En Rk A> SC AY AK EI o Wi 
GetAllPages() 如 果 用 户 选 择 了 打印 整个 文档 这 一 选项 ， 则 返 


m] True ° 
SetCollate(flag) 
GetCollate() cae 对 了 核对 打印 的 页 ， 则 返 
SetFromPage(page) 

如 果 用 户 选择 从 东 一 页 打印 ， 那 么 返回 打 


GetFromPage() 印 的 第 一 页 的 整数 页 ia « 


SetMaxPage(page) 
GetMaxPage() 返回 文档 中 最 大 的 页 码 
SetMinPage(page) 
GetMinPage() 返回 文档 中 最 小 的 页 码 


SetNoCopies() 
GetNoCopies() 返回 用 户 选择 要 打印 的 副本 的 数量 。 
SetPrintData(printData) 


返回 与 对 话 框 相关 联 的 wx.PrintData 对 
象 o 


GetPrintData() 


SetPrintToFile(flag) 

如 果 用 户 已 经 选择 了 打印 到 一 个 文件 这 一 项 ， 
GetPrintToFile() 那么 返回 True 。“ 打 印 到 文件 "这 一 机 制 

由 wxPython 管理 。 
SetSelection(flag) 


如 果 用 户 已 经 选择 了 只 打印 当前 的 选择 这 一 


GetSelection 4 
2 项 ， 那 么 返回 True ° 


SetToPage(page) 


如 果 用 户 指定 了 一 个 范围 ， 那 么 返回 打印 的 最 
GetToPage( ) BRANE o 
被 GetPrintData() 方法 返回 的 wx.PrintData 实例 提供 了 有 关 打 印 的 更 进一步 
的 信息 。 通 常 这 些 信息 是 在 你 的 打印 对 话 框 的 打印 设置 子 对 话 框 中 的 。 表 17.3 列 出 
了 wx.PrintData 对 象 的 属性 。 


表 17.3 wx.PrintData 的 属性 


SetColour (flag) 


GetColour() deck S ATAT E ZH T ER AT ep a > RAS 
SetDuplex(mode) 

返回 当前 关于 双 面 打印 的 设置 。 值 可 以 

是 wx.DUPLEX SIMPLE ( 非 双 面 打 


fF) > wx.DUPLEX HORIZONTAL (横向 双 
印 ) > wx.DUPLEX VERTICAL (纵向 双 面 


GetDuplex() 


SetOrientation(orientation) 


i 2 -g9g Td 当 ay = o uu 
GetOrientation() pius dst (肖像 或 风景 ) o 1% 


wx.LANDSCAPE 和 wx.PORTRAIT ° 
SetPaperId(paperId) 

返回 匹配 纸张 类 型 的 标识 符 。 通 常 的 值 
GetPaperId() 有 wx.PAPER LETTER, wx.PAPER LEGAL, 
完整 的 页 面 (纸张 ) ID 的 列表 见 wxwidc 


SetPrinterName(printerName) 


返回 被 系统 引用 的 当前 打印 机 的 名 字 。 如 村 
GetPrinterName() 么 默认 打印 机 被 使 用 。 
SetQuality(quality) 

GetQuality() 返回 打印 机 的 当前 品质 值 。 set * 方 法 仅 韦 


如 何 显 示 页 面 设 置 对 话 框 ? 


图 17.4 显 示 了 页 面 设置 对 话 框 是 如 何 让 用 户 来 设置 与 页 面 尺 寸 相 关 的 数据 的 。 
图 17.4 


Print Setup 








Figure 17.3 
The print setup dialog 





创建 页 面 设置 对 话 框 


你 可 以 通过 实例 化 一 个 wx.PageSetupDialog 类 来 创建 一 个 页 面 设置 对 话 框 。 
wx.PageSetupDialog(parent, data=None) 


参数 parent 是 新 的 对 话 框 的 父 窗口 。 参 

数 data 是 wx.PageSetupDialogData 的 一 个 实例 默认 为 None 。 一 旦 页 面 设置 
对 话 框 被 创建 了 ， 那 么 这 个 对 话 框 的 行为 就 和 其 它 任 何 模 式 对 话 框 一 样 ， 并 且 你 可 
以 使 用 ShowModal() 来 显示 它 。 通 常 ， 返 回 值 表 明了 用 户 是 否 是 使 

用 wx.ID OK 或 wx.ID CANCEL 按钮 关闭 的 对 话 框 窗口 。 在 对 话 框 关闭 后 ， 你 可 
以 通过 调用 GetPageSetupDialogData() 来 取得 对 数据 对 象 的 访问 ， 
GetPageSetupDialogData() 返回 类 wx.PageSetupDialogData 的 一 个 实例 。 


使 用 页 面 设置 属性 工作 

wx.PageSetupDialogData 类 有 几 个 必须 与 页 面 设 置 一 起 使 用 的 属性 。 表 17.4 展 
示 了 控制 对 话 框 自身 显示 的 属性 。 除 非 有 其 它 的 指定 ， 否 则 所 有 这 些 属性 都 默认 
为 True 。 


表 17.4 wx.PageSetupDialogData 的 对 话 框 控制 属性 


GetDefaultMinMargins() 


SetDefaultMinMargins(flag) 


GetDefaultInfo() 


SetDefaultinfo(flag) 


EnableHelp(flag) 
GetEnableHelp() 
EnableMargins(flag) 
GetEnableMargins() 
EnableOrientation(flag) 
GetEnableOrientation() 
EnablePaper(flag) 
GetEnablePaper() 
EnablePrinter(flag) 


GetEnablePrinter() 


如 果 这 个 属性 为 True ， 并 且 你 是 在 微软 
的 windows 系统 上 上， 那么 页 面 设置 将 使 
用 默认 打印 机 的 当前 属性 作为 默认 认 的 最 
小 化 页 边 距 。 否 则 ， 它 将 使 用 系统 默认 


值 。 


如 果 这 个 属性 为 True ， 并 且 你 是 在 微软 
的 Windows AAL PARR OEE 
对 话 框 不 会 被 显示 。 替 而 代 之 ， 当 前 打印 
机 的 所 有 默认 值 都 将 被 放 入 数据 对 象 。 


如 果 为 True ， 那 么 对 话 框 的 帮助 部 分 是 
有 效 的 。 


如 果 为 True ， 那 么 对 话 框 的 用 于 调整 页 
边 距 的 部 分 是 有 效 的 。 


如 果 为 True ， 那 么 对 话 框 的 用 于 改变 页 
面 定 位 的 部 分 是 有 效 的 。 


如 果 为 True ， 那 么 对 话 框 的 用 于 允许 用 
户 改变 页 面 (ASK) 类 型 的 部 分 是 效 的 。 


如 果 为 True ， 那 么 允许 用 户 设 置 打 印 机 
的 按钮 是 有 效 的 。 


表 17.5 显 示 了 wx.PageSetupDialogData 类 的 附加 的 属性 ， 这 些 属性 用 于 控制 页 
面 的 边 距 和 尺寸 。 


表 17.5 wx.PageSetupDialogData 的 页 边 距 和 尺寸 属性 


GetMarginTopLeft() 


get 方法 返回 一 个 wx.Point * Kv 
的 值 x 是 当前 的 左边 距 ，y 是 当前 的 上 边 
SetMarginTopLeft(pt) 距 。 set 方法 允许 你 使 用 一 
个 wx.Point 或 一 个 Python 元 组 来 改 
变 这 些 值 S 
GetMarginBottomRight() 


get 方法 返回 一 个 wx.Point ， 其 中 
的 值 X 是 当前 的 右边 距 ，y 是 当前 的 下 边 
SetMarginBottomRight(pt) 距 。 set 方法 允许 你 使 用 一 
个 wx.Point 或 一 个 Python 元 组 来 改 
变 这 些 值 。 
GetMinMarginTopLeft( ) 


E] GetMarginTopLeft() 中 的 一 样 ， 只 


SetMinMarginTopLeft(pt) Ad EB Ae YE © Gh Sito bah oe 


GetMinMarginBottomRight( ) 


E] GetMarginBottomRight() 中 的 一 
SetMinMarginBottomRight (pt) 样 ， 只 是 值 是 所 允许 的 最 小 右边 距 和 下 
i $B o 
GetPaperId() 


返回 关于 当前 页 面 类 型 的 wxPython 标 


SetPaperId(id Lae i 
P S) 识 符 。 同 wx.PrinterData 的 属性 。 


GetPaperSize() 

get * 方 法 返回 包含 页 面 的 水 平和 坚 直 
SetPaperSize(size) 方向 尺寸 的 一 个 wx.Size 实例 。 单 位 是 
GetPrintData() 
get “方法 返回 与 当前 打印 会 话 相关 


SetPrintData(printData) ETT Cea 


到 目前 为 止 ， 我 们 已 经 讨论 了 所 有 关于 数据 对 话 框 的 整改 ， 下 面 我 们 将 重点 放 在 打 
印 上 面 。 


如 何 打 印 ? 


到 目前 为 止 ， 我 们 已 经 见 过 了 打印 构架 的 所 有 部 分 ， 现 是 我 们 打印 一 些 东 西 的 时 候 
了 。 实 际 的 打印 部 分 是 由 wx.Printer 类 的 一 个 实例 来 控制 的 。 与 已 经 说 明 的 其 
它 部 分 相 比 ， 打 印 并 不 更 简单 。 接 下 来 ， 我 们 将 对 在 例 17.1 中 的 onPrint() 中 的 


步骤 作 介 绍 。 
第 一 步 按 顺序 得 到 你 的 所 有 数据 


这 至 少 应 该 包括 带 有 打印 机 命令 的 wx.Printout 对 象 ， 通 常 也 要 包括 一 
个 wx.PrintDialogData 实例 。 


第 二 步 创建 一 个 wx.Printer 实例 


创建 该 实例 ， 要 使 用 构造 器 wx.Printer(data-None) 。 可 选 参数 data 是 一 
个 wx.PrintDialogData 实例 。 该 数据 控制 打印 ， 通 常 ， 你 会 想 使 用 它 


Ek 一 


第 三 步 使 用 wx.Printer 的 Print () 方法 打印 
Print() 方法 如 下 : 


Print(parent, printout, prompt=True) 


其 中 参数 parent 是 当 打 印 时 所 触发 的 对 话 框 的 父 窗 口 。 printout 是 用 于 打印 
的 wx.Printout 对 象 。 如 果 参 数 prompt 为 True ， 那 么 在 打印 之 前 显示 打印 对 
话 框 ， 否 则 将 立即 ; 启动 打印 。 


如 果 打 印 成 功 ， 则 Print() 方法 返回 True 。 你 能 够 调用 GetLastError() 7 
法 来 得 到 下 列 常 量 之 一 : wx.PRINTER_CANCELLED (如 果 失 败 是 由 于 用 户 取消 了 
打印 所 引起 的 ) ， wx.PRINTER ERROR (如 果 失 败 在 打印 期 间 由 打印 自身 所 引起 
的 ) ， 或 wx.PRINTER NO ERROR (如 果 Print() 返回 True 且 没 有 错误 发 
生 ) 。 


这 儿 还 有 另外 两 个 你 可 以 使 用 一 个 wx.Printer 实例 做 的 事 : 


e 你 可 以 使 用 createAbortwindow(parent,printout) 来 显示 中 止 对 话 框 ， 
中 参数 E printout 同 Print() 方法 中 的 。 如 果 用 户 ae 
任务 ， 你 能 够 通过 调用 Abort() 来 发 现 ， 该 方法 在 这 种 情况 下 返回 True 。 


e 你 可 以 使 用 PrintDialog(parent) 来 显 式 地 显示 打印 对 话 框 ， 并 且 你 可 以 使 
用 GetPrintDialogData() 来 得 到 活动 的 打印 数据 对 象 。 


如 何 实现 一 个 打印 预览 ? 

使 用 设备 上 下 文 的 一 个 好 处 就 是 REY ERA RE ， 你 可 以 使 用 一 个 屏幕 设备 上 
下 文 来 代替 打印 机 设备 上 下 文 。 接 下 来 的 三 部 分 将 讨论 打 印 预 览 的 过 程 。 

第 一 步 创建 预览 实例 


在 一 个 打印 预览 中 的 第 一 步 是 创建 类 wx.PrintPreview 的 一 个 实 
例 ， wx.PrintPreview 类 似 wx.Printer 。 构 造 器 如 下 : 


wx.PrintPreview(printout, printoutForPrinting, data=None) 


其 中 参数 printout 是 一 个 wx.Printout 对 象 ， 用 于 管理 预览 。 参 
数 printoutForPrinting 是 另 一 个 wx.Printout 对 象 。 如 果 它 不 是 None > "P 
么 当 显 示 的 时 候 ， 该 打印 预览 窗口 包含 一 Print 按钮 ， 该 按钮 启动 打 
fF ^ printoutForPrinting 用 于 实际 的 打印 。 如 果 参 
数 printoutForPrinting 为 None > ARA Print 按钮 不 显示 。 当 然 ， 你 可 以 传 
北 同 一 个 实例 或 你 的 自 定义 打印 输出 类 的 相同 版 本 的 两 个 实例 给 参 
数 printout 和 printoutForPrinting ° Až data 可 以 是 一 
个 wx.PrintData 对 象 或 一 个 wx.PrintDialogData 对 象 。 如 果 参 数 data 指定 
了 的 话 ， 那 么 它 被 用 于 控制 该 打印 预览 。 在 例 17.1 中 ， 我 们 显示 了 一 个 
在 OnPrintPreview() 方法 中 使 用 打印 预览 的 例子 。 


第 二 步 创建 预览 框架 
一 旦 你 有 了 你 的 wx.PrintPreview ， 你 就 需要 一 框架 以 在 其 中 观看 你 


的 wx.PrintPreview 。 该 框架 由 类 wx.PreviewFrame it 
供 ，wx.PreviewFrame 是 wx.Frame 的 一 个 子 类 ， wx.Frame 为 预览 提供 基本 
的 用 户 交 互 控 件 。 wx. PreviewFrame 的 构造 器 如 下 : 


wx.PreviewFrame(preview, parent, title, pos=wx.DefaultPosition, 
size-wx.DefaultSize, style-wx.DEFAULT FRAME STYLE, 
name="frame" ) 


pubes 义 的 参数 是 preview ， 它 是 要 被 预览 的 wx.PrintPreview 实例 。 
它 的 参数 都 是 标准 的 wx .Frame bu ^ wx.PreviewFrame 不 定义 任何 自 定 义 的 
" 式 或 事件 。 


第 三 步 初始 化 框架 


在 你 显示 你 的 wx.PreviewFrame 之 前 ， 你 需要 调用 Initialize() 方法 ， 该 方 
法 创建 窗口 的 内 部 的 部 件 并 做 其 它 的 内 部 的 计 莫 。 一 旦 你 Show() TRIER? BA 
如 果 你 想 再 改变 预览 窗口 的 感 观 ， 你 可 以 使 用 考 

Š CreateControlBar() 和 CreateCanvas() 方法 ， 它 们 分 别 创建 

类 wx.PreviewControlBar 和 wx.PreviewCanvas 的 对 象 。 禾 盖 这 些 方法 以 创建 
你 自己 的 画布 ( canvas) 和 /或 控制 栏 对 象 ， 使 得 你 能 够 定制 你 的 打印 预览 窗口 的 
感 观 。 


本 草 小 结 


1、 这 是 wxPython 中 的 一 人 通用 的 打印 构架 架 ， 它 不 仅 可 以 打印 HTML ， 还 可 以 打 
印 任何 能 够 被 绘制 到 设备 上 下 文 的 东西 。 这 个 架构 中 的 主要 的 类 


是 wx.Printout ， 但 是 wx.Printer 和 wx.PrintPreview 也 是 重要 的 。 


2^ wx.Printout 类 管理 图 形 打 印 的 细节 ， 并 且 它 包含 几 个 可 以 被 覆盖 来 定制 打 
印 会 话 期 间 的 行为 和 使 用 的 数据 的 方法 。 打 印发 生 在 OnPrintPage() 方法 期 间 。 


3、 用 于 打印 机 设置 和 页 面 设 置 的 标准 的 对 话 框 是 可 以 从 wxPython 来 访问 的 。 打 
印 机 设置 对 话 框 是 wx.PrintDialog 的 一 个 实例 ， 页 面 设置 对 话 框 

是 wx.PageSetupDialog 的 一 个 实例 。 这 两 个 对 话 框 都 有 相关 的 数据 类 ， 数 据 类 
使 你 的 程序 可 以 处 理 所 有 显示 在 对 话 框 中 的 值 。 


4、 一 旦 有 了 数据 ， 那 么 实际 将 数据 传送 给 打印 机 则 是 wx.Printer 类 的 相对 简单 
的 应 用 。 你 可 以 使 用 wx.PrintPreview 类 来 管理 一 个 打印 预览 会 话 ， 该 类 包括 一 
个 打印 预览 框架 ， 和 根据 该 框架 指定 通常 打印 行为 的 选项 。 


第 十 八 章 使 用 wxPython 的 其 他 功能 


本 章 内 容 : 

放置 对 象 到 剪贴 板 上 

拖 放 

传送 和 获取 自 定 义 对 象 

使 用 wx.Timer 设置 定时 的 事件 


e 编写 多 线程 的 wxPython 应 用 程序 


放置 对 象 到 剪贴 板 上 


在 wxPython 中 ， 剪 贴 板 和 拖 放 特 性 是 紧密 相关 的 。 期 间 ， 内 部 窗口 的 通信 是 由 使 
用 wx.DataObject 类 或 它 的 子 类 的 一 个 实例 作为 中 介 的 。 wx.Data0bject 是 一 
个 特殊 的 数据 对 象 ， 它 包含 描述 输出 数据 格式 的 元 数据 。 我 们 将 从 剪贴 板 入 手 ， 然 
后 我 们 将 讨论 拖 放 的 不 同 处 理 。 


对 于 一 个 剪 切 和 粘贴 操作 ， 有 三 个 元 素 : 
e source( 7&) 
e clipboard( 剪贴 板 ) 
e target( 目标 ) 


如 果 source 是 在 你 的 应 用 程序 中 ， 那 么 你 的 应 用 程序 负责 创 
建 wx.DataObject 的 一 个 实例 并 把 它 放 到 剪贴 板 对 象 。 通 常 source 都 是 在 你 的 
应 用 程序 的 外 部 。 


这 里 的 clipboard 是 一 个 全 局 对 象 ， 它 容纳 数据 并 在 必要 时 与 操作 系统 的 剪贴 板 
交互 。 


target 对 象 负责 从 剪贴 板 获取 wx.Dataobject 并 把 它 转换 为 对 你 的 应 用 程序 有 
用 的 那 一 类 数据 。 


得 到 剪贴 板 中 的 数据 


如 果 你 想 你 的 应 用 程序 能 够 引起 一 个 剪贴 事件 ， 也 就 是 说 你 想 能 够 将 数据 剪 切 或 复 
制 到 剪贴 板 ， 把 数据 放置 到 一 个 wx.DataObject 里 面 。 wx,Data0bject 知道 自 
己 能 够 被 读 写 何 种 格式 的 数据 。 这 点 是 比较 重要 的 ， 例 如 如 果 你 当时 正在 写 一 个 词 
处 理 程 序 并 希望 给 用 户 在 粘贴 时 选择 无 格式 文本 的 粘贴 或 丰富 文本 格式 的 粘贴 的 情 
况 。 然 而 大 多 数 时 候 ， 在 你 的 剪贴 板 行为 中 不 需要 太 强 大 或 太 灵活 的 性 能 。 对 于 最 
常用 的 情况 ， wxPython 提供 了 三 个 预定 义 的 wx.Dataobject FA: 纯 文本 ， 
位 图 图 像 和 文件 名 。 


要 传递 纯 文本 ， 可 以 创建 类 wx.TextDataObject 的 一 个 实例 ， 使 用 它 如 下 的 构造 


way 
ae . 


wx. TextDataObject(text="") 


参数 text 是 你 想 传递 到 剪贴 的 文本 。 你 可 以 使 用 Text(text) 方法 来 设置 该 文 
本 ， 你 也 可 以 使 用 GetText() 方法 来 得 到 该 文本 ， 你 还 可 以 使 
用 GetTextLength() 方法 来 得 到 该 文本 的 长 度 。 


一 旦 你 创建 了 这 种 数据 对 象 后 ， 接 着 你 必须 访问 剪贴 板 。 系 统 的 剪贴 板 

在 wxPython 中 是 一 个 全 局 性 的 对 象 ， 名 为 wx.TheClipboard 。 要 使 用 它 ， 可 以 
使 用 它 的 Open() 方法 来 打开 它 。 如 果 该 剪贴 板 被 打开 了 则 该 方法 返回 True ， 
否则 返回 False 。 如 果 该 剪贴 板 正 在 被 另 一 应 用 程序 写 入 的 话 ， 该 剪贴 板 的 打开 
有 可 能 会 失败 ， 因 此 在 使 用 该 剪贴 板 之 前 ， 你 应 该 检查 打开 方法 的 返回 值 。 当 你 使 
用 完 剪贴 板 之 后 ， 你 应 该 调用 它 的 Close() 方法 来 关闭 它 。 打 开 剪 贴 板 会 阻塞 其 
它 的 剪贴 板 用 户 的 使 用 ， 因 此 剪贴 板 打 开 的 时 间 应 该 尽 可 能 的 短 。 


处 理 剪贴 板 中 的 数据 


一 旦 你 有 了 打开 的 剪贴 板 ， 你 就 可 以 处 理 它 所 和 包含 的 数据 对 象 。 你 可 以 使 

用 SetData(data) 来 将 你 的 对 象 放置 到 剪贴 板 上 ， 其 中 参数 data 是 一 

个 wx.DataObject 实例 。 你 可 以 使 用 方法 clear() 方法 来 清空 剪贴 板 。 如 果 你 
希望 在 你 的 应 用 程序 结束 后 ， 剪 贴 板 上 的 数据 还 存在 ， 那 么 你 必须 调用 方 

法 Flush() ， 该 方法 命令 系统 维持 你 的 数据 。 否 则 ， 该 wxPython 剪贴 板 对 象 在 
你 的 应 用 程序 退出 时 会 被 清除 。 


下 面 是 一 段 添加 文本 到 剪贴 板 的 代码 : 


text_data = wx.TextDataObject("hi there") 
if wx.TheClipboard.Open(): 
wx. TheClipboard.SetData(text_data) 

wx. TheClipboard.Close() 


获得 剪贴 板 中 的 文本 数据 


从 剪贴 板 中 获得 文本 数据 也 是 很 简单 的 。 一 旦 你 打开 了 剪贴 板 ， 你 就 可 以 调 

用 GetData(data) 方法 ， 其 中 参数 data 是 wx,Data0bject 的 一 些 特定 的 子 类 
的 一 个 实例 。 如 果 剪 贴 板 中 的 数据 能 够 以 与 方法 中 的 数据 对 象 参 数 相 一 致 的 某 种 格 
式 被 输出 的 话 ， 该 方法 的 返回 值 则 为 True 。 这 里 ， 由 于 我 们 传递 进 的 是 一 

个 wx.TextDataObject ， 那 么 返回 值 True 就 意味 该 剪贴 板 能 够 被 转换 到 纯 文 
本 。 下 面 是 一 段 样 例 代 码 : 


text data = wx.TextDataObject() 

if wx.TheClipboard.Open(): 

success - wx.TheClipboard.GetData(text data) 
wx.TheClipboard.Close() 

if success: 

return text data.GetText() 


注意 ， 当 你 从 剪贴 板 获取 数据 时 ， 数 据 并 不 关 pg 到 剪贴 板 
的 。 剪 贴 板 中 的 数据 本 身 被 底层 的 操作 系统 所 管理 ， wxPython 的 责任 是 确保 格式 
的 匹配 及 你 能 够 得 到 你 能 够 处 理 的 数据 格式 。 


实战 剪贴 板 


在 这 一 节 ， 我 们 将 显示 一 个 简单 的 例子 ， 它 演示 了 如 何 与 剪贴 板 交 换 数 据 。 它 是 一 
个 有 着 两 个 按钮 的 框架 ， 它 使 用 户 能 够 复制 和 粘贴 文本 。 当 你 运行 这 个 例子 时 ， 结 
果 将 会 如 图 18.1 所 示 。 
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例 18.1 是 产生 图 18.1 的 代码 。 
例 18.1 剪贴 板 交互 示例 


#-*- encoding:UTF-8 -*- 
import wx 


TISTE NN 

The whole contents of this control 
will be placed in the system's 
clipboard when you click the copy 
button below. 


t2 text = """\ 

If the clipboard contains a text 
data object then it will be placed 
in this control when you click 

the paste button below. Try 


copying to and pasting from 
other applications too! 


class MyFrame(wx.Frame): 
def _init_ (self): 
wx.Frame.__init__(self, None, title="Clipboard", 
size=(500, 300) ) 
p = wx.Panel(self) 


# create the controls 
self.ti = wx.TextCtrl(p, -1, t1 text, 

style-wx.TE MULTILINE |wx.HSCROLL ) 
self.t2 - wx.TextCtrl(p, -1, t2 text, 

style-wx.TE MULTILINE |wx.HSCROLL ) 
copy - wx.Button(p, -1, "Copy") 
paste - wx.Button(p, -1, "Paste") 


# setup the layout with sizers 

fgs - wx.FlexGridSizer(2, 2, 5, 5) 
fgs.AddGrowableRow(90) 
fgs.AddGrowableCol(0) 
fgs.AddGrowableCol(1) 
fgs.Add(self.ti1, ©, wx.EXPAND) 
fgs.Add(self.t2, 0, wx.EXPAND) 
fgs.Add(copy, 0, wx.EXPAND) 
fgs.Add(paste, 0, wx.EXPAND) 
border - wx.BoxSizer() 
border.Add(fgs, 1, wx.EXPAND|wx.ALL, 5) 
p.SetSizer(border) 


# Bind events 
self.Bind(wx.EVT BUTTON, self.OnDoCopy, copy) 
self.Bind(wx.EVT BUTTON, self.OnDoPaste, paste) 


def OnDoCopy(self, evt):#Copy4e 424) #4 2 3E we 

data = wx.TextDataObject() 

data.SetText(self.t1.GetValue()) 

if wx.TheClipboard.Open(): 
wx. TheClipboard.SetData(data)#1$ 242 zx & 5| 3j Ws RE 
wx.TheClipboard.Close() 

else: 
wx.MessageBox("Unable to open the clipboard", "Error 


D 
def OnDoPaste(self，evt) :#Paste 按 钮 的 事件 处 理 函 数 
Success = False 
data = wx.TextDataObject() 
if wx.TheClipboard.Open(): 
success = wx.TheClipboard.GetData(data)4ZJA 3j W 43442] HK 
据 


wx. TheClipboard.Close() 


Af success: 
self .t2.SetValue(data.GetText() )# 更 新 文本 控件 
else: 
wx .MessageBox ( 
"There is no data in the clipboard in the requir 


ed format", 
HENRO) 


app = wx.PySimpleApp() 
frm = MyFrame() 
frm.Show() 
app.MainLoop() 


获得 剪贴 板 中 的 文本 数据 


从 剪贴 板 中 获得 文本 数据 也 是 很 简单 的 。 一 旦 你 打开 了 剪贴 板 ， 你 就 可 以 调 

用 GetData(data) 方法 ， 其 中 参数 data 是 wx.DataObject 的 一 些 特定 的 子 类 
的 一 个 实例 。 如 果 剪 贴 板 中 的 数据 能 够 以 与 方法 中 的 数据 对 象 参 数 相 一 致 的 某 种 格 
式 被 输出 的 话 ， 该 方法 的 返回 值 则 为 True 。 这 里 ， 由 于 我 们 传递 进 的 是 一 

个 wx.TextDataObject ， 那 么 返回 值 True 就 意味 该 剪贴 板 能 够 被 转换 到 纯 文 
本 。 下 面 是 一 段 样 例 代码 : 


text data = wx.TextDataObject() 

if wx.TheClipboard.Open(): 

success - wx.TheClipboard.GetData(text data) 
wx.Theclipboard.Close() 

if success: 

return text data.GetText() 


注意 ， 当 你 从 剪贴 板 获 取 数 据 时 ， 数 据 并 不 关心 是 哪个 应 用 程序 将 它 放 置 到 剪贴 板 
的 。 剪 贴 板 中 的 数据 本 身 被 底层 的 操作 系统 所 管理 ， wxPython 的 责任 是 确保 格式 
的 匹配 及 你 能 够 得 到 你 能 够 处 理 的 数据 格式 。 


实战 剪贴 板 

在 这 一 节 ， 我 们 将 显示 一 个 简单 的 例子 ， 它 演示 了 如 何 与 剪贴 板 交 换 数据 。 它 是 一 
个 有 着 两 个 按钮 的 框架 ， 它 使 用 户 能 够 复制 和 粘贴 文本 。 当 你 运行 这 个 例子 时 ， 结 
果 将 会 如 图 18.1 所 示 。 

图 18.1 
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例 18.1 是 产生 图 18.1 的 代码 。 
例 18.1 剪贴 板 交互 示例 


#-*- encoding:UTF-8 -*- 
import wx 


tiite t = See 

The whole contents of this control 
will be placed in the system's 
Clipboard when you click the copy 
button below. 


L2 text = """\ 

If the clipboard contains a text 
data object then it will be placed 
in this control when you click 

the paste button below. Try 
copying to and pasting from 

other applications too! 


class MyFrame(wx.Frame): 
def _ init (self): 
wx.Frame.__init__(self, None, title="Clipboard", 
size=(500, 300) ) 
p = wx.Panel(self) 


# create the controls 


self.ti = wx.TextCtrl(p, -1, t1 text, 
style-wx.TE MULTILINE wx.HSCROLL ) 
self.t2 - wx.TextCtrl(p, -1, t2 text, 


style-wx.TE MULTILINE |wx.HSCROLL ) 
copy - wx.Button(p, -1, "Copy") 
paste - wx.Button(p, -1, "Paste") 


# setup the layout with sizers 

fgs = wx.FlexGridSizer(2, 2, 5, 5) 
fgs.AddGrowableRow(90) 

fgs .AddGrowableCol(0) 


fgs.AddGrowableCol(1) 

fgs.Add(self.ti1, ©, wx.EXPAND) 
fgs.Add(self.t2, 0, wx.EXPAND) 
fgs.Add(copy, 0, wx.EXPAND) 
fgs.Add(paste, 0, wx.EXPAND) 

border - wx.BoxSizer() 

border.Add(fgs, 1, wx.EXPAND|wx.ALL, 5) 
p.SetSizer(border) 


# Bind events 
self.Bind(wx.EVT BUTTON, self.OnDoCopy, copy) 
self.Bind(wx.EVT BUTTON, self.OnDoPaste, paste) 


def OnDoCopy(self, evt):#Copy4<e 424) #4 2b 3E he 

data = wx.TextDataObject() 

data.SetText(self.t1.GetValue()) 

if wx.TheClipboard.Open(): 
wx. TheClipboard.SetData(data)#1$ 242 zx & 5| 9j Wi da E. 
wx.TheClipboard.Close() 

else: 
wx.MessageBox("Unable to open the clipboard", "Error 


uy) 
def OnDoPaste(self, evt):4ZPastedz428 3E fFAb HHH 
success - False 
data = wx.TextDataObject() 
if wx.TheClipboard.Open(): 
success = wx.TheClipboard.GetData(data)4ZJA 3j W 43442] HK 
据 


wx. TheClipboard.Close() 


if success: 
self.t2.SetValue(data.GetText())4 2 3t x AszEH 
else: 
wx.MessageBox( 
"There is no data in the clipboard in the requir 
ed format", 
ENRON) 


app = wx.PySimpleApp() 
frm = MyFrame() 


frm.Show() 
app.MainLoop() 


在 下 一 节 中 ， 我 们 将 讨论 如 何 传递 其 它 格 式 的 数据 ， 如 位 图 。 


传递 其 它 格式 的 数据 


经 由 剪贴 板 交 互 位 图 几乎 与 传递 文本 相同 。 你 所 使 用 的 相关 的 数据 对 象 子 类 

是 wx.BitmapDataObject ， 其 get 方法 和 set 方法 分 别 

是 GetBitmap() 和 SetBitmap(bitmap) 。 经 由 该 数据 对 象 与 剪贴 板 交 互 的 数据 
对 象 必 须 是 wx.Bitmap 类 型 的 。 


最 后 一 个 预定 义 的 数据 对 象 类 型 是 wx.FileDataobject 。 通 常 该 数据 对 象 被 用 于 
拖 放 中 (将 在 18.2 节 中 讨论 ) ， 例 如 当 你 将 一 个 文件 从 你 的 资源 管理 器 或 查找 窗口 
放置 到 你 的 应 用 程序 上 时 。 你 可 以 使 用 该 数据 对 象 从 剪贴 板 接受 文件 名 数据 ， 并 且 
你 可 以 使 用 方法 GetFilenames() 来 从 该 数据 对 象 获取 文件 名 ， 该 方法 返回 一 个 

文件 名 的 列表 ， 列 表 中 的 每 个 文件 名 是 已 经 被 添加 到 剪贴 板 的 文件 名 。 你 可 以 使 用 
该 数据 对 象 的 AddFile(file) 方法 来 将 数据 放置 到 剪贴 板 上 ， 该 方法 将 一 个 文件 
名 字符 串 添 加 到 该 数据 对 象 。 这 里 没有 其 它 的 方法 用 于 直接 处 理 列表 ， 所 以 这 就 要 
靠 你 自己 了 。 本 章 的 稍 后 部 份 ， 我 们 将 讨论 如 何 经 由 剪贴 板 传送 自 定义 对 象 ， 以 及 
ho fe] 46,3308. Ho 


拖 放 源 


拖 放 是 一 个 类 似 剪 切 和 粘贴 的 功能 。 它 是 在 你 的 应 用 程序 的 不 同 部 分 之 间或 两 个 不 
同 的 应 用 程序 之 间 传 送 数据 。 由 于 管理 数据 和 格式 几乎 是 相同 的 ， 所 
以 wxPython 同样 使 用 wx.DataObject 族 来 确保 对 格式 作 恰 当 的 处 理 。 


拖 放 和 剪 切 粘贴 的 最 大 不 同 是 ， 剪 切 粘 贴 信 赖 于 中 介 剪 贴 板 的 存在 。 因 为 是 剪贴 板 
管理 数据 ， 所 以 源 程序 将 数据 传送 后 就 不 管 之 后 的 事情 了 。 这 对 于 拖 放 却 不 然 ， 源 
应 用 程序 不 仅 虽 要 创建 一 个 拖 动 管理 器 来 服务 于 剪贴 板 ， 而 且 它 也 必须 等 待 目标 应 
用 程序 的 响应 。 不 同 于 一 个 剪贴 板 的 操作 ， 在 拖 放 中 ， 是 目标 应 用 来 决定 操作 是 一 
个 剪贴 或 拷贝 ， 所 以 源 应 用 必须 等 待 以 确定 传送 的 数据 所 用 的 目的 。 


通常 ， 对 源 的 拖 动 操作 是 在 一 个 事件 处 理 函 数 中 进行 ， 通 常 是 一 个 鼠标 事件 ， 因 为 
拖 动 通常 都 随和 鼠标 的 按 下 事件 发 生 。 创 建 一 个 拖 动 源 要 求 四 步 : 

1、 创 建 数 据 对 象 2、 创 建 wx.Dropsource 实例 3、 执 行 拖 动 操 作 4、 取 消 或 允许 
释放 

步骤 1 创建 一 个 数据 对 象 

这 第 一 步 是 创建 你 的 数据 对 象 。 这 在 早先 的 剪贴 板 操作 中 有 很 好 的 说 明 。 对 于 简单 
的 数据 ， 使 用 预定 义 的 wx.DataObject 的 子 类 是 最 简单 的 。 有 了 数据 对 象 后 ， 你 
可 以 创建 一 个 释放 源 实例 

步骤 2 创建 释放 源 实 例 

接 下 来 的 步骤 是 创建 一 个 wx.Dropsource 实例 ， 它 扮演 类 似 于 剪贴 板 这 样 的 传送 
角色 。 wx.DropSource 的 构造 函数 如 下 : 


wx.DropSource(win, iconCopy=wx.NullIconOrCursor, 
iconMove=wx.NullIconOrCursor, 
iconNone=wx.NullIconOrCursor ) 


参数 win 是 初始 化 拖 放 操 作 的 窗口 对 象 。 其 余 的 三 个 参数 用 于 使 用 自 定 义 的 图 片 
来 代表 鼠标 的 拖 动 意义 (拷贝 、 移 动 、 取 消 释 放 ) 。 如 果 这 三 个 参数 没有 指定 ， 那 
么 使 用 系统 的 默认 值 。 在 微软 的 windows 系统 上 ， 图 片 必 须 是 wx.cursor 对 
象 ， 对 于 Unix 则 应 是 wx.Icon 对 象 一 Mac OS 目前 忽略 你 的 自 定义 图 片 。 


一 旦 你 有 了 你 的 wx.Dropsource 实例 ， 那 么 就 可 以 使 用 方法 SetData(data) 来 
将 你 的 数据 对 象 关联 到 wx.DropSource 实例 。 接 下 来 我 们 将 讨论 实际 的 拖 动 。 


步 又 3 执行 拖 动 


拖 动 操作 通过 调用 释放 源 的 方法 DoDragDrop(flags-wx.Drag CopyOnly) 来 开 
始 。 参 数 flags 表示 目标 可 对 数据 执行 的 何 种 操作 。 取 值 

有 wx.Drag AllowMove ， 它 表示 批准 执行 一 个 移动 或 找 

贝 ，wx.Drag_DefaultMove 表示 不 仅 允 许 执 行 一 个 移动 或 拷贝 ， 而 且 做 默认 的 移 
动 操作 ， wx.Drag CopyOnly 表示 只 执行 一 个 拷贝 操作 。 


步骤 4 处 理 释 放 


DoDragDrop() 方法 直到 释放 被 目标 取消 或 接受 才 会 返回 。 在 此 期 间 ， 虽 然 绘 制 
事件 会 继续 被 发 送 ， 但 你 的 应 用 程序 的 线程 被 阻塞 。 DoDragDrop() 的 返回 值 基 
于 目标 所 要 求 的 操作 ， 取 值 如 下 : 


wx.DragCancel (对 于 取消 操作 而 言 ) 

wx.Dragcopy (对 于 拷贝 操作 而 言 ) 

wx.DragMove (对 于 移动 操作 而 言 ) 

wx.DragNone (对 于 错误 而 言 ) 

对 这 些 返回 值 的 响应 由 你 的 应 用 程序 来 负责 。 通 常 对 于 响应 移动 要 删除 被 拖 动 的 数 
据 外 ， 对 于 拷贝 则 是 什么 也 不 用 做 。 

实战 拖 动 

例 18.2 显 示 了 一 个 完整 的 拖 动 源 控件 ， 适 合 于 通过 拖 动 上 面 的 箭头 图 片 到 你 的 系统 
的 任何 接受 文本 的 应 用 上 (如 Microsoft word ) 。 图 18.2 图 示 了 这 个 例子 。 

图 18.2 
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1118.2 一 个 小 的 拖 动 源 控 件 


#-*- encoding:UTF-8 -*- 


import wx 


class DragController(wx.Control): 


Just a little control to handle dragging the text from a text 


control. 


We use a separate control so as to not interfere with 


the native drag-select functionality of the native text control 


def _init__(self, parent, source, size=(25,25)): 
wx.Control. init (self, parent, -1, size=size, 


style-wx.SIMPLE BORDER) 


self.source - source 

self.SetMinSize(size) 

self.Bind(wx.EVT PAINT, self.OnPaint) 
self.Bind(wx.EVT LEFT DOWN, self.OnLeftDown) 


def OnPaint(self, evt): 
# draw a simple arrow 


dc 


- wx.BufferedPaintDC(self) 


dc.SetBackground(wx.Brush(self.GetBackgroundColour())) 
dc.Clear() 
w, h = dc.GetSize() 


yo 


h/2 


dc.SetPen(wx.Pen("dark blue", 2)) 
dc.DrawLine(w/8, y, Ww-w/8, y) 
dc.DrawLine(w-w/8, y, w/2, h/4) 
dc.DrawLine(w-w/8, y, w/2, 3*h/4) 


def OnLeftDown(self, evt): 
text = self.source.GetValue() 
data = wx.TextDataObject(text) 
dropSource = wx.DropSource(self)z| € ftx 7f. 
dropSource.SetData(data)4 E 24 
result = dropSource.DoDragDrop(wx.Drag_AllowMove) #447 # 


放 


# if the user wants to move the data then we should dele 


te it 


# from the source 
if result == wx.DragMove: 


self.source.SetValue("")# 如 果 需 要 的 话 ， 删 除 源 中 的 数据 


class MyFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init__(self, None, title="Drop Source") 
p = wx.Panel(self) 


# create the controls 
label1 = wx.StaticText(p, -1, "Put some text in this con 


ious) 
label2 = wx.StaticText(p, -1, 
"Then drag from the neighboring bitmap and\n" 
"drop in an application that accepts dropped\n" 
"text, such as MS Word.") 
text = wx.TextCtrl(p, -1, "Some text") 
dragctl = DragController(p, text) 


# setup the layout with sizers 

sizer = wx.BoxSizer(wx.VERTICAL) 
sizer.Add(label1, ©, wx.ALL, 5) 

hrow = wx.BoxSizer(wx.HORIZONTAL) 
hrow.Add(text, 1, wx.RIGHT, 5) 
hrow.Add(dragctl, 0) 

sizer.Add(hrow, 0, wx.EXPAND|wx.ALL, 5) 
sizer.Add(label2, 0, wx.ALL, 5) 
p.SetSizer(sizer) 

sizer.Fit(self) 


app - wx.PySimpleApp() 
frm = MyFrame() 

frm. Show() 

app .MainLoop( ) 


接 下 来 ， 我 们 将 给 你 展示 目标 处 的 拖 放 。 


拖 放 到 的 目标 


实现 拖 放 到 的 目标 的 步骤 基本 上 借鉴 了 实现 拖 放 源 的 步骤 。 其 中 最 大 的 区 别 是 ， 实 
现 拖 放 源 ， 你 可 以 直接 使 用 类 wx.DropSource ， 而 对 于 目标 ， 你 首先 必须 写 你 的 
自 定义 的 wx.DropTarget 的 子 类 。 一 旦 你 有 了 你 的 目标 类 ， 你 将 需要 创建 它 的 一 
个 实例 ， 并 通过 使 用 wx.window 的 SetDropTarget(target) 方法 将 该 实例 与 任 
一 wx.Window 的 实例 关联 起 来 。 设 置 了 目标 后 ， wx.Window 的 实例 (不 论 它 是 
一 个 窗口 ， 一 个 按钮 ， 一 个 文本 域 或 其 它 的 控件 ) 就 变 成 了 一 个 有 效 的 释放 目标 。 
为 了 在 你 的 释放 目标 上 接受 数据 ， 你 也 必须 创建 一 个 所 需要 类 型 

的 wx.DataObject 对 象 ， 并 使 用 释放 目标 方 

法 SetDataObject(data) 将 wx.DataObject 对 象 与 释放 目标 关联 起 来 。 在 实际 
释放 操作 前 ， 你 需要 预先 定义 数据 对 象 ， 以 便 该 释放 目标 能 够 正确 地 处 理 格式 。 要 
从 目标 获取 该 数据 对 象 ， 有 一 个 方法 GetData0bject() 。 下 面 的 样板 代码 使 得 释 
放 目 标 能 够 接受 文本 ( 仅 能 接受 文本 ) 。 这 是 因为 数据 对 象 已 经 被 设置 

为 wx.TextDataObject 的 一 个 实例 。 


class MyDropTarget(wx.DropTarget): 
def _ init (self): 

self.data = wx.TextDataObject() 
self .SetDataObject(data) 

target = MyDataTarget() 
win.SetDropTarget(target ) 


使 用 你 的 释放 到 的 目标 


当 一 个 释放 发 生 时 ， 你 的 wx.DropTarget 子 类 的 各 种 事件 函数 将 被 调用 。 其 中 最 
重要 的 是 OnData(x, y, default) ， 它 是 你 必须 在 你 自 定义 的 释放 目标 类 中 履 盖 
的 一 个 事件 方法 。 参 数 x,y 是 释放 时 鼠标 的 位 置 。 default 参数 

是 DoDragDrop() 的 四 个 取 值 之 一 ， 具 体 的 值 基于 操作 系统 ， 传 递 

给 DoDragDrop() 标志 和 当 释 放 发 生 时 修饰 键 的 状态 。 在 且 仅 在 OnData() 方法 
中 ， 你 可 以 调用 GetData() 。 GetData() 方法 要 求 来 自 释 放 源 的 实际 的 数据 并 
把 它 放 入 与 你 的 释放 目标 对 象 相 RRA EEA EP GetData() 不 返回 数据 对 
象 ， 所 以 你 通常 应 该 用 一 个 实例 变量 来 包含 你 的 数据 对 象 。 下 面 是 关 
 MyDropTarget.OnData() 的 样板 代码 : 


def OnData(self, x, y, default): 
self .GetData() 
actual_data = self.data.GetText() 
# Do something with the data here... 
return default 


OnData() 的 返回 值 应 该 是 要 导致 操作 一 一 你 应 该 返回 参数 default 的 值 ， 除 非 
这 儿 有 一 个 错误 并 且 你 需要 返回 wx.DragNone 。 一 旦 你 有 了 数据 ， 你 就 可 以 对 它 
作 你 想 做 的 。 记 住 ， 由 于 OnData() 返回 的 是 关于 所 导致 操作 的 相关 信息 ， 而 非 数 
据 本 身 ， 所 以 如 果 你 想 在 别处 使 用 该 数据 的 话 ， 你 需要 将 数据 放置 在 一 个 实例 变量 
里 面 (该 变量 在 该 方法 外 仍然 可 以 被 访问 ) e 


在 释放 操作 完成 或 取消 后 ， 返 回 自 OnData() 的 导致 操作 类 型 的 数据 被 

从 DoDragDrop() 的 返回 ， 并 且 释 放 源 的 线程 将 继续 进行 。 

在 wx.DropTarget 类 中 有 五 个 On... 方法 ， 你 可 以 在 你 的 子 类 中 黎 盖 它们 以 在 
目标 被 调用 时 提供 自 定 义 的 行为 。 。 我 们 已 经 见 过 了 其 中 的 ondata() ， 另 外 的 如 
"Pes 

OnDrop(x, y) OnEnter(x, y, default)  OnDragOver(x, y, default) 
OnLeave() 


其 中 的 参数 x, y, default F) OnData() ° RPL AREY ik > dde RRE 
在 你 的 应 用 程序 中 提供 自 定 义 的 功能 的 话 ， 你 可 以 履 盖 这 些 方法 。 


当 鼠 标 进入 释放 到 的 目标 区 域 时 ， OnEnter() 方法 首先 被 调用 。 你 可 以 使 用 该 方 
法 来 更 新 一 个 状态 窗口 。 该 方法 返回 如 果 释放 发 生 时 要 执行 的 操作 (通常 

是 default 的 值 ) 或 wx.DragNone (如 果 你 不 接受 释放 的 话 ) 。 该 方法 的 返回 
值 被 wxPython 用 来 指定 当 鼠 标 移动 到 窗口 上 时 ， 哪 个 图 标 或 光标 被 用 作 显 示 。 当 
和 鼠标 位 于 窗口 中 时 ， 方 法 OnDragOver() 接着 被 调用 ， 它 返回 所 期 望 的 操作 

或 wx.DragNone 。 当 鼠标 被 释放 并 且 释 放 ( drop) 发 生 时 ， OnDrop() 方法 被 调 
用 ， 并 且 它 默认 调用 OnData() 。 最 后 ， 当 光标 退出 窗口 时 OnLeave() 被 调用 。 


与 数据 对 象 一 同 ， wxPython 提供 了 两 个 预定 义 的 释放 到 的 目标 类 来 涵盖 最 常见 的 
情况 。 除 了 在 这 些 情况 中 预定 义 的 类 会 为 你 处 理 wx.Datadbject ， 你 仍然 需要 创 
建 一 个 子 类 并 覆盖 一 个 方法 来 处 理 相关 的 数据 。 关 于 文本 ， 

类 wx.TextDropTarget 提供 了 可 履 盖 的 方法 OnDropText(x, y, data) ， 你 将 
使 用 通过 履 盖 该 方法 来 替代 履 盖 OnData() 。 参 数 x,y 是 释放 到 的 坐标 ， 参 

数 data 是 被 释放 的 字符 串 ， 该 字符 串 你 可 以 立即 使 用 面 不 用 必须 对 数据 对 象 作 更 
多 的 查询 。 如 果 你 接受 新 的 文本 的 话 ， 你 的 履 盖 应 该 返回 True > GIER 

回 False 。 对 于 文件 的 释放 ， 相 关 的 预定 义 的 类 是 wx.FileDropTarget ， 并 且 
可 和 履 盖 的 方法 是 OnDropFiles(x, y, filenames) ， 参 数 filenames 是 被 释放 
的 文件 的 名 字 的 一 个 列表 。 另 外 ， 必 要 的 时 候 你 可 以 处 理 它 们 ， 当 完成 时 可 以 返 
回 True 或 False 。 








例 18.3 中 的 代码 显示 了 如 何 创 建 一 个 框架 (窗口 ) 用 以 接受 文件 的 释放 。 你 可 以 通 

Pop bec id eqs. A Mn ) 上 来 测试 例子 代码 ， 并 
观 查 显示 在 窗口 中 的 关于 文件 的 信息 。 图 18.3 是 运行 后 的 结果 。 

图 18.3 
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9118.3 文件 释放 到 的 目标 的 相关 代码 





#-*- encoding:UTF-8 -*- 
import wx 


class MyFileDropTarget(wx.FileDropTarget ):#* 9]££7x £| & H tz 
def _ init (self, window): 
wx.FileDropTarget. init__(self) 
self.window = window 


def OnDropFiles(self, x, y, filenames) :##xX x HAIE h AiE 
self .window.AppendText("\n%d file(s) dropped at (%d,%d): 
\n" % 
(len(filenames), x, y)) 
for file in filenames: 
self .window.AppendText("\t%s\n" % file) 


class MyFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init__(self, None, title-"Drop Target", 
$ize=(500, 300) ) 
p = wx.Panel(self) 


# create the controls 
label - wx.StaticText(p, -1, "Drop some files here:") 
text - wx.TextCtrl(p, -1, "", 

style-wx.TE MULTILINE|wx.HSCROLL) 


# setup the layout with sizers 

sizer - wx.BoxSizer(wx.VERTICAL) 
sizer.Add(label, ©, wx.ALL, 5) 
sizer.Add(text, 1, wx.EXPAND|wx.ALL, 5) 
p.SetSizer(sizer) 


4 make the text control be a drop target 
dt = MyFileDropTarget(text )# 将 文本 控件 作为 释放 到 的 目标 
text.SetDropTarget(dt) 


app - wx.PySimpleApp() 
frm = MyFrame() 

frm. Show() 

app .MainLoop( ) 


到 目前 为 止 ， 我 们 还 是 局 限于 对 wxPython 的 预定 义 的 对 象 的 数据 传送 的 讨论 。 接 
下 来 ， 我 们 将 讨论 如 何 将 你 自己 的 数据 放 到 剪贴 板 上 。 


传送 自 定义 对 象 


使 用 wxPython 的 预定 义 的 数据 对 象 ， 你 只 能 工作 于 纯 文 本 、 位 图 或 文件 。 而 更 有 
创建 性 的 是 ， 你 应 该 让 你 自 定义 的 对 象 能 够 在 应 用 之 间 被 传送 。 在 这 一 节 ， 我 将 给 
你 展示 如 何 给 你 的 wxPython 应 用 程序 增加 更 高 级 的 性 能 ， 如 传送 自 定义 的 数据 对 


象 和 以 多 种 格式 传送 一 个 对 象 。 


传送 自 定 义 的 数据 对 办 


尽管 文本 、 位 图 的 数据 对 象 和 文件 名 的 列表 对 于 不 同 的 使 用 已 经 足够 了 ， 但 有 时 你 
仍然 需要 传送 自 定 义 的 对 象 ， 如 你 自己 的 图 形 格 式 或 一 个 自 定 义 的 数据 结构 。 接 下 
来 ， 在 保留 对 你 的 对 象 将 接受 的 数据 的 类 型 的 控制 时 ， 我 们 将 涉及 传送 自 定 义 数 据 
对 象 的 机 制 。 该 方法 的 局 限 是 它 只 能 工作 在 wxPython 内 ， 你 不 能 使 用 这 个 方法 来 
让 其 它 的 应 用 程序 去 读 你 的 自 定 义 的 格式 。 要 将 RTF (丰富 文本 格式 ) 传送 

给 Microsoft Word ， 该 机 制 将 不 工作 。 


要 实现 自 定义 的 数据 传送 ， 我 们 将 使 用 wxPython 的 
类 wx.CustomDataObject ， 它 被 设计 来 用 于 处 理 任意 的 数 
据 。 wx.CustomDataObject 的 构造 器 如 下 : 


wx.CustomDataObject(format=wx.FormatInvalid) 


参数 format 技术 上 应 该 是 类 wx.DataFormat 的 一 个 实例 ， 但 为 了 我 们 的 目的 ， 
我 们 可 以 只 给 它 传递 一 个 字符 串 ， 数 据 类 型 的 责任 由 wxPython 来 考虑 。 我 们 只 需 
要 这 个 字符 串 作为 自 定 义 格 式 的 一 个 标签 ， 以 与 其 它 的 区 分 开 来 。 一 旦 我 们 有 了 我 
们 自 定 义 的 数据 实例 ， 我 们 就 可 以 使 用 方法 SetData(data) 将 数据 放 入 到 自 定 义 
的 数据 实例 中 。 参 数 data 必须 是 一 个 字符 串 。 下 面 是 一 段 样板 代码 : 


data_object = wx.CustomDataObject("MyNiftyFormat" ) 
data = cPickle.dumps(my object) 
data object.SetData(data) 


在 这 段 代码 片断 之 后 ， 你 可 以 将 data_object 传递 到 剪贴 板 或 另 一 个 数据 源 ， 以 
继续 数据 的 传送 。 


得 到 自 定 义 对 象 


要 得 到 该 对 象 ， 需 要 执行 相同 的 基本 步骤 。 对 于 从 剪贴 板 获 取 ， 先 创建 相同 格式 的 
一 个 自 定义 数据 对 象 ， 然 后 得 到 数据 并 对 得 到 的 数据 进行 逆 pickle 操作 
( pickle 有 加 工 的 意思 ) 。 


data object = wx.CustomDataObject("MyNiftyFormat" ) 
if wx.TheClipboard.Open(): 

success = wx.TheClipboard.GetData(data object) 

wx. TheClipboard.Close() 

if success: 

pickled data = data object.GetData() 

object - cPickle.loads(pickled data) 


拖 放 工 作 是 类 似 的 。 使 用 已 pickle 的 数据 设置 释放 源 的 数据 对 象 ， 并 将 设置 的 
据 对 象 给 你 的 自 定义 的 数据 对 象 ， 数 据 的 目标 在 它 的 OnData() 方法 中 对 数据 进 
逆 pickle 操作 并 把 数据 放 到 有 用 的 地 方 。 


创建 自 定 义 对 象 的 另 一 个 方法 是 建造 你 自己 的 wx.Dataobject 子 类 。 如 果 你 选择 
这 条 途径 ， 那 么 你 会 希望 实现 你 自己 的 诸如 wx.PyDataobjectSimple (用 于 通常 
EXE) 
或 wx.PyTextDataObject * wx.PyBitmapDataObject, 或 wx.PyFileDataObje 
的 一 个 子 类 。 这 将 使 你 能 够 覆盖 所 有 必要 的 方法 。 


多 种 格式 传送 对 象 


使 用 wxPython 的 数据 对 象 来 用 于 数据 传送 的 最 大 好 处 是 ， 数 据 对 象 了 解数 据 格 
式 。 一 个 数据 对 象 甚至 能 够 用 多 种 的 格式 来 管理 相同 的 数据 。 例 如 ， 你 可 能 希望 你 
自己 的 应 用 程序 能 够 接受 你 的 自 定 义 的 文本 格式 对 象 的 数据 ， 但 是 你 仍然 希望 其 它 
的 应 用 能 够 以 纯 文 本 的 格式 接受 该 数据 。 


管理 该 功能 的 机 制 是 类 wx.DataObjectComposite 。 目 前 ， 我 们 所 见 过 的 所 有 被 
继承 的 数据 对 象 都 是 wx.DataObjectSimple 的 子 

类 。 wx.DataObjectComposite 的 目的 是 将 任意 数量 的 简单 数据 对 象 合并 为 一 个 
数据 对 象 。 该 合并 后 的 对 象 能 够 将 它 的 数据 提供 给 与 构成 它 的 任 一 简单 类 型 匹配 的 
一 个 数据 对 象 。 


要 建造 一 个 合成 的 数据 对 象 ， 首 先 要 使 用 一 个 无 参 的 构造 

器 wx.DataObjectComposite() 作为 开始 ， 然 后 使 

用 Add(data，preferred=False) 分 别 增加 简单 数据 对 象 。 要 建造 一 个 合并 了 你 
的 自 定义 格式 和 纯 文本 的 数据 对 象 ， 可 以 如 下 这 样 : 


data object = wx.CustomDataObject("MyNiftyFormat" ) 
data object.SetData(cPickle.dumps(my object)) 

text object - wx.TextDataObject(str(my object)) 
composite - wx.DataObjectComposite() 
composite.Add(data object) 

composite.Add(text object) 


此 后 ， 将 这 个 合成 的 对 象 传 递 给 剪贴 板 或 你 的 释放 源 。 如 果 目 标 类 要 求 一 个 使 用 了 
a 定义 格式 的 对 象 ， 那 么 它 接 受 已 pickle VA Ro wWREBRAT AN RE > AB 
么 它 得 到 字符 串 表 达 式 。 


下 节 内 容 : 我 们 将 给 你 展示 如 何 使 用 一 个 定时 器 来 管理 定时 事件 。 
使 用 wx.Timer 来 设置 定时 事件 


有 时 你 需要 让 你 的 应 用 程序 产生 基于 时 间 段 的 事件 。 要 得 到 这 个 功能 ， 你 可 以 使 用 


类 wx.Timer 。 


产生 EVT_TIMER 事 件 

对 wx.Timer 最 灵活 和 最 有 效 的 用 法 是 使 它 产 生 EVT_TIMER ， 并 将 该 事件 如 同 其 
它 事件 一 样 进行 绑 定 。 

创建 定时 器 

要 创建 一 个 定时 器 ， 首 先 要 使 用 下 面 的 构造 器 来 创建 一 个 wx.Timer 的 实例 。 


wx.Timer (owner=None, id=-1) 


其 中 参数 owner 是 实现 wx.EvtHandler 的 实例 ， 即 任 一 能 够 接受 事件 通知 

的 wxPython 控件 或 其 它 的 东西 。 参 数 id 用 于 区 分 不 同 的 定时 器 。 如 果 没 有 指 
X id ， 则 wxPython 会 为 你 生成 一 个 id 号 。 如 果 当 你 创建 定时 器 时 ， 你 不 想 
设置 参数 owner 和 id ， 那 么 你 可 以 以 后 随时 使 

用 SetOwner(owner=None, id= -1) 方 法 来 设置 ， 它 设置 同样 的 两 个 参数 。 


JR AY E 
FAROE T PN EX dg ydeTd4—1:89]48 59 RAEN AY 3E EAE SE JEDE P DR 
定 wx.EVT TIMER 事件 。 


self.Bind(wx.EVT TIMER, self.OnTimerEvent ) 


如 果 你 需要 绑 定 多 个 定时 器 到 多 个 处 理 函 数 ， 你 可 以 给 Bind 函数 传递 每 个 定时 器 
的 ID ， 或 将 定时 器 对 象 作为 源 参 数 来 传递 。 


timeri = wx.Timer(self) 
timer2 wx.Timer(self) 
self.Bind(wx.EVT TIMER, self.OnTimeriEvent, timeri) 
self.Bind(wx.EVT TIMER, self.OnTimer2Event, timer2) 


启动 和 停止 定时 器 


在 定时 器 事件 被 绑 定 后 ， 你 所 需要 做 的 所 有 事情 就 是 启动 该 定时 器 ， 使 用 方 

法 Start(milliseconds- -1, oneShot-False) 。 其 中 参数 milliseconds X 
毫秒 数 。 这 将 在 经 过 milliseconds 时 间 后 ， 产 生 一 个 wx.EVT TIMER 事件 。 如 
果 milliseconds= -1， 那 么 将 使 用 早先 的 毫秒 数 。 如 果 oneshot 为 True > Jf 
么 定时 器 只 产生 wx.EVT_TIMER 事件 一 次 ， 然 后 定时 器 停止 。 否 则 ， 你 必须 显 式 
地 使 用 Stop() 方法 来 停止 定时 器 。 例 18.4 使 用 了 定时 器 机 制 来 驱动 一 个 数字 时 
钟 ， 并 每 秒 刷 新 一 次 显示 。 


例 18.4 一 个 简单 的 数字 时 钟 


#-*- encoding:UTF-8 -*- 
import wx 
import time 


class ClockWindow(wx.Window) : 
def _init__(self, parent): 
wx.Window. (init (self, parent) 
self.Bind(wx.EVT PAINT, self.OnPaint) 
self.timer = wx.Timer (self )# 创 建 定时 器 
self.Bind(wx.EVT TIMER, self.OnTimer, self.timer)##<— 
个 定时 器 事件 
self.timer .Start(1000 )# 设 定时 间 问 隔 


def Draw(self，dc) :# 绘 制 当 前 时 间 
t = time.localtime(time.time()) 
st = time.strftime("%I:%M:%S", t) 
w, h = self.GetClientSize() 
dc.SetBackground(wx.Brush(self.GetBackgroundColour())) 
dc.Clear() 
dc.SetFont(wx.Font(30, wx.SWISS, wx.NORMAL, wx.NORMAL)) 
tw, th = dc.GetTextExtent(st) 
dc.DrawText(st, (w-tw)/2, (h)/2 - th/2) 


def OnTimer(self, evt):4 £z IH SHAT HX 
dc = wx.BufferedDC(wx.ClientDC(self)) 
self.Draw(dc) 


def OnPaint(self, evt): 
dc = wx.BufferedPaintDC(self) 
self.Draw(dc) 


class MyFrame(wx.Frame): 
def _ init (self): 
wx.Frame. init__(self, None, title="wx.Timer") 
ClockWindow(self ) 


app = wx.PySimpleApp() 
frm = MyFrame() 

frm. Show() 

app .MainLoop( ) 


确定 当前 定时 器 的 状态 


你 可 以 使 用 方法 IsRunning() 来 确定 定时 器 的 当前 状态 ， 使 用 方 
法 GetInterval() 来 得 导 到 当前 的 时 间 间 隔 。 如 果 定 时 器 正在 运行 并 且 只 运行 一 次 
的 话 ， 方 法 IsOneShot() 返回 True 。 


wx.TimerEvent 几乎 与 它 的 父 类 wx.Event 是 一 样 的 ， 除 了 它 不 包 
括 wx.GetInterval() 方法 来 返回 定时 器 的 时 间 间 隔 外 。 万 一 你 将 来 自 多 个 定时 
器 的 事件 绑 定 给 了 相同 的 处 理 函 数 ， 并 希望 根据 特定 的 定时 器 的 事件 来 做 不 同 的 动 


作 的 话 ， 可 使 用 事件 方法 GetId() 来 返回 定时 器 的 ID ， 以 区 别 对 待 。 
学 习 定 时 器 的 其 它 用 法 


另 一 种 使 用 ee wx.Timer "在 你 的 子 类 中 你 可 以 覆盖 方 

父 类 中 ， 该 方法 每 次 在 定时 器 经 过 指定 的 时 间 间 隔 后 被 自动 调 
, CARNE ros o 然而 你 的 子 类 没有 义务 去 触发 一 个 定时 器 事件 ， 你 可 以 在 

Notify() 方法 中 做 你 想 做 的 事 ， 以 响应 定时 器 的 时 间 间 隔 。 


要 在 未 来 茶 时 触发 一 个 特定 的 行为 ， 有 一 个 被 称 为 wx.Futurecall 的 类 可 以 使 
用 。 它 的 构造 器 如 下 : 


wx.FutureCall(interval, callable, *args, **kwargs) 


一 旦 它 被 创建 后 ， wx.,FutureCall 的 实例 将 等 待 interval 毫秒 ， 然 后 调用 传递 
给 参数 callable 的 对 象 ， 参 数 args, * kwargs 是 callable 中 的 对 象 所 要 使 
用 的 。 wx.FutureCall 只 触发 一 次 定时 事件 。 


下 节 内 容 提示 : 创建 一 个 多 线程 的 wxPython 应 用 程序 


创建 一 个 多 线程 的 wxPython 应 用 程序 


在 大 多 数 的 GUI 应 用 程序 中 ， 在 应 用 程序 的 后 台中 长 期 执行 一 个 处 理 过 程 而 不 干 

涉 用 户 与 应 用 程序 的 其 它 部 允许 后 合 处 理 的 机 制 通 常 是 产生 
SAE AET 长 期 执行 一 个 处 理 过 程 。 对 于 wxPython 的 多 线程 ， 在 这 一 
节 我 们 有 两 点 需要 特别 说 明 。 


最 重要 的 一 点 是 ， GUI 的 操作 必须 发 生 在 主线 程 或 应 用 程序 的 主 循环 所 处 的 地 方 

中 。 在 一 个 单独 的 线程 中 执行 GUI 操作 对 于 无 法 预知 的 程序 崩溃 和 调试 来 说 是 一 

个 好 的 办 法 。 基 于 技术 方面 的 原因 ， 如 许多 Unix 的 GUI 库 不 是 线程 安全 性 的 ， 

以 及 在 微软 windows 下 UI 对 象 的 创建 问题 ， wxPython 没有 设计 它 自己 的 发 生 
在 多 线程 中 的 事件 ， 所 以 我 们 建议 你 也 不 要 尝试 。 


上 面 的 禁令 包括 与 屏幕 交互 的 任何 项 目 ， 尤 其 包括 wx.Bitmap 对 象 。 


F wxPython 应 用 程序 ， 关 于 所 有 UI 的 更 新 ， 后 台 线 程 只 负责 发 送 消息 
合 UI 线程 ， 而 不 关心 GUI 的 更 新 。 幸 运 的 是 ， wxPython a IR E AR BE aS 
M MIA 8 


在 这 一 节 ， 我 们 将 关注 几 个 wxPython 中 实现 多 线程 的 方法 。 最 常用 的 技术 是 使 
用 wx.callafter() 函数， 一 会 我 们 会 讨论 它 。 然 后 ， 我 们 将 看 一 看 如 何 使 

用 Python 的 队列 对 象 来 设置 一 个 并 行事 件 队 列 。 最 后 ， 我 们 将 讨论 如 何 为 多 线程 
开发 一 个 定制 的 解决 方案 。 


使 用 全 局 函数 wx.CallAfter() 


例 18.5 显 示 了 一 个 使 用 线程 的 例子 ， 它 使 用 了 wxPython % 4) & 

数 wx.Callafter() ， 该 函数 是 传递 消息 给 你 的 主线 程 的 最 容易 的 方 

法 。 wx.CallAfter() 使 得 主线 程 在 当前 的 事件 处 理 完成 后 ， 可 以 对 一 个 不 同 的 
线程 调用 一 个 函数 。 传 递 给 wx.CallAfter() 的 函数 对 象 总 是 在 主线 程 中 被 执 
行 。 

图 18.4 显 示 了 多 线程 窗口 的 运行 结果 。 

图 18.4 


Multi-threaded GUI 
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例 18.5 显 示 了 产生 图 18.4 的 代码 
例 18.5 使 用 wx.callAfter() 来 传递 消息 给 主线 程 的 一 个 线程 例子 


#-*- encoding:UTF-8 -*- 
import wx 

import threading 

import random 


class WorkerThread(threading. Thread) : 


This just simulates some long-running task that periodically se 

nds 

a message to the GUI thread. 

def _ init (self, threadNum, window): 

threading.Thread. init (self) 
self.threadNum - threadNum 
self.window - window 
self.timeToQuit - threading.Event() 
self.timeToQuit.clear() 
self.messageCount - random.randint(10, 20) 
self.messageDelay = 0.1 + 2.0 * random.random() 


def stop(self): 
self.timeToQuit.set() 


def run(self) :# 运 行 一 个 线程 
msg = "Thread %d iterating %d times with a delay of %1.4 
aes 


% (self.threadNum, self.messageCount, self.message 


Delay) 
wx.CallAfter(self.window.LogMessage, msg) 


for i in range(1, self.messageCount+1): 
self .timeToQuit.wait(self .messageDelay ) 
if self.timeToQuit.isSet(): 
break 
msg = "Message %d from thread %d\n" % (i, self.threa 
dNum) 
wx.CallAfter(self.window.LogMessage, msg) 
else: 
wx.CallAfter(self.window.ThreadFinished, self) 


class MyFrame(wx.Frame): 
def — init (self): 
wx.Frame. init (self, None, title="Multi-threaded GUI" 
self.threads - [] 
self.count = 0 


panel = wx.Panel(self) 

startBtn = wx.Button(panel, -1, "Start a thread") 

stopBtn = wx.Button(panel, -1, "Stop all threads") 

self.tc = wx.StaticText(panel, -1, "Worker Threads: 00") 

self.log = wx.TextCtrl(panel, -1, "", 
style=wx.TE_RICH|wx.TE_MULTILINE) 


inner = wx.BoxSizer(wx.HORIZONTAL ) 

inner .Add(startBtn, ©, wx.RIGHT, 15) 

inner .Add(stopBtn, ©, wx.RIGHT, 15) 

inner .Add(self.tc, ©, wx.ALIGN CENTER VERTICAL) 
main = wx.BoxSizer(wx.VERTICAL) 

main.Add(inner, ©, wx.ALL, 5) 
main.Add(self.log, 1, wx.EXPAND|wx.ALL, 5) 
panel.SetSizer(main) 


self.Bind(wx.EVT BUTTON, self.OnStartButton, startBtn) 
self.Bind(wx.EVT BUTTON, self.OnStopButton, stopBtn) 
self.Bind(wx.EVT CLOSE, self.OnCloseWindow) 


self.UpdateCount() 


def OnStartButton(self, evt): 
self.count += 1 
thread = WorkerThread(self.count, self )#@]#@—*2.4 
self .threads.append(thread) 
self .UpdateCount() 
thread.start( )# 启 动 线程 


def OnStopButton(self, evt): 
self .StopThreads() 
self .UpdateCount() 


def OnCloseWindow(self, evt): 
self .StopThreads() 
self .Destroy() 


def StopThreads(self):# 从 池 中 删除 线程 
while self.threads: 
thread = self.threads[0] 
thread.stop() 
self.threads.remove(thread) 


def UpdateCount(self): 
self.tc.SetLabel("Worker Threads: %d" % len(self.threads 


def LogMessage(self，msg):# 注 册 一 个 消息 
self .log.AppendText(msg) 


def ThreadFinished(self, thread): RA 
self.threads.remove(thread) 
self.UpdateCount() 


app - wx.PySimpleApp() 
frm = MyFrame() 

frm. Show() 

app .MainLoop( ) 


上 面 这 个 例子 使 用 了 Python 的 threading 模块 。 上 面 的 代码 使 

用 wx.CallAfter(func, args) 传递 方法 给 主线 程 。 这 将 发 送 一 个 事件 给 主线 
程 ， 之 后 ， 事 件 以 标准 的 方式 被 处 理 ， 并 触发 对 Func( args) 的 调用 。 因 些 ， 
在 这 种 情况 中 ， 线 程 在 它 的 生命 周期 期 间 调用 LogMessage() ， 并 在 线程 结束 前 
调用 ThreadFinished() 。 


使 用 队列 对 象 管理 线程 的 通信 


尽管 使 用 callafter() 是 管理 线程 通信 的 最 简单 的 方法 ， 但 是 它 并 不 是 唯一 的 机 
制 。 你 可 以 使 用 Python 的 线程 安全 的 队列 对 象 去 发 送 命令 对 象 给 UI 线程 。 这 

个 UI 线程 应 该 在 wx.EVT IDLE 事件 的 处 理 函 数 中 写成 需要 接受 来 自 该 队列 的 命 
As 


本 质 上 ， 你 要 为 线程 通信 设置 一 个 并 行 的 事件 队列 。 如 果 使 用 这 一 方法 ， 那 么 工作 
线程 在 当 它 们 增加 一 个 命令 对 象 到 队列 时 ， 应 该 调用 全 局 函 

数 wx.WakeUpIdle() 以 确保 尽 可 能 存在 在 一 个 空闲 事件 。 这 个 技术 

比 wx.CallAfter() 更 复杂 ， 但 也 更 灵活 。 特 别 是 ， 这 个 机 制 可 以 帮助 你 在 后 台 
线程 间 通 信 ， 虽 然 所 有 的 GUI 处 理 仍 在 主线 程 上 。 


开发 你 自己 的 解决 方案 


你 也 可 以 让 你 自己 的 工作 线程 创建 一 个 wxPython 事件 (标准 的 或 自 定 义 的 ) ， 并 
使 用 全 局 函数 wx.PostEvent(window, event) 将 它 发 送 给 Ur 线程 中 的 一 个 特 
定 的 窗口 。 该 事件 被 添加 到 特定 窗口 的 未 决 事件 队列 中 ， 并 且 wx.wakeUpIdle B 
动 被 调用 。 这 条 道 的 好 处 是 事件 将 遍历 的 wxPython 事件 设置 ， 这 意味 你 将 自由 地 
得 到 许多 事件 处 理 能 力 ， 坏 处 是 你 不 得 不 自己 管理 所 有 的 线程 

和 wx.CallAfter() 函数 所 为 你 做 的 事件 处 理 。 


本 章 小 结 


1、 拖 放 和 剪贴 板 事件 是 非常 相似 的 ， 两 者 都 使 用 了 wx.DataObject 来 作为 数据 

格式 的 媒介 。 除 了 可 以 创建 自 定义 的 格式 以 外 ， 还 存在 着 默认 的 数据 对 和 象 ， 和 包括 文 
本 ， 文 件 和 位 图 。 在 剪贴 板 的 使 用 中 ， 全 局 对 象 wx.TheClipboard 管理 数据 的 传 
送 并 代表 底层 系统 的 剪贴 板 。 


2、 对 于 拖 放 操 作 ， 拖 动 源 和 拖 动 到 的 目标 一 起 工作 来 管理 数据 传送 。 拖 动 源 事件 
被 阻塞 直到 拖 动 到 的 目标 作出 该 拖 动 操作 是 否 有 效 的 判断 。 


3^ X wx.Timer 使 你 能 够 设置 定时 的 事件 。 


4、 线 程 在 wxPython 是 可 以 实现 的 ， 但 时 确保 所 有 的 GUI 活动 发 生 在 主线 程 中 
是 非常 重要 的 。 你 可 以 使 用 函数 wx.callAfter() 来 管理 内 部 线程 的 通信 问题 。 


